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INTRODUCTION TC SYCOM 


GENERAL 


The Systems Communications Modute CSYCOM) program provides the 
B1800/B1700 user with: 1) the capability to submit jobs to run 
on ancther system» 2) to transfer files between two systems» and 
3) in general» to interactively obtein services and information 
frog another system with the ability to communicate with 
interactive programs tn a remote syste@e. Job run output can be 
returred to the submitting system Cufpon request) or directed to a 
peripteral device on the processirg system itself. Interactive 
output data is returned to the User System directly» via Network 
Contrclters. | 


SYCGN along with its associated Netwerk Controller is responsible 
for alt data communications with other systems. This includes 
performing the necessary functions tc establish tine connections» 


receive/trans#it datas and execute 


procedurese 


e tes + : -s 
ne correct cine Ceremination 


The Systems Comnunications Module maintains a secondary level of 
contrcl CMCP has primary control) cver local peripheral devices 
such es the card readers» card punches Line printer» and magnetic 
tapese Tt reads and transfers cards tapes and disk filess 
accepts input from and displays a#essages to the Operator's 
Terminal (CDT) and receives data fiiles/messages for printing» 
punchings display» cr writing tc either tape or disk. It 
provides the mechanism by which a terminal or application program 
in one system is able to communicate with specific application 
progréms in another system. Prograw selection is based on the 
servicing systen which dictates the processing requirements 
Cprograms) optioned to run tn that system. 


SCOPE AND OBJECTIVES 


The purpose of the Systems Coumunications Nodule is to increase 
the use of data processing facilities Csystems) either tocal = or 
femote to the target system. The scope of SYCOM jis to provide 
all of those features previously affcerded by the Remote Job Entry 
CRJE/ZTERMINAL) system and additionatly provide enhancements with 
the following exfansive communications features: file transfers 
termiral-to~progqran»s program~to*prcgrams and program-to-SYCOM. 
The first two functions assume intersystem communications with 
the program~to-SYCQOmM function assuming intra~system communication 


which is proviced by the MCP. The Systems Communications Module 
with these encompassing capabilities» considerably expands the 
flexitility of a RJE Stations herceforth referred to as a “User 


Syster“. 
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In addition to the above design otjectives» several mandatory 
objectives have been specified. They are: 1) Retain 
compatibility with the standard Burroughs data comagunications 
Line discipline and sessage format ccnventions and 2) maintain 
standard Remote Job Entry CRJE) command compatibility with 
existing RJE progras products for nueesuans small» smsedium»s and 
large Systemse 


With this software system» the objectives are also to provide the 
user with the most benefits in terms of flexibility and ease of 
USC e Flexibility in that the user is free to design and install 
systems configurations suited to the recuiresents of the company 
for distributed processing. For examples a user can install a 
B1800/81700 in the same instatlation to increase/share resources | 
with an existing systems in a remote instatlation to place some 
resources in a remote facility, or in a network of systems to 
provide distributed processing servicese Ease of use in that atl 
capabilities of the systea can be selectively utilized by any 
user thru,either command initiated cr inherent system functions. 


FUNCTIONS PERFORMED 


Since SYCOM applications iaply transmission of large data files 
between two or more systems» line throughput maximizations error 
detection» and error recovery are standard features. Following 
is a comprehensive List of the functions per formed, including 
those that are under user controt.j They are presented in three 
groups» Basics Line Throughput» and Error Detection and Recovery. 


BASIC FEATURES 


For SYCOM to accomplish the functions generally described for the 


systems» the following basic features are provideds full details 
are presented in Section IIe “Concepts and Facilities”. 


Ae Input: Introduction of prcgrags from an input device 
on the focal systems for cospilation and/or execution on 
a remote systeme Introduction of data from an input 
device on the local systes fcr processing on the remote 
system. 


Be Command Input: SYCOM coasands as well as SMCS/MCP type 
comgands are permitted froa the systes ODT» terminals» 
and specificatty tailored zpplication programs running 
in a system. 


Ce Output: Dispersion of data and/or programs produced by 
the remote system to the tocat systeas peripheral 
output devicese ODTs terminais» and appitication 


progranse 
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Oe Monitoring: Monitoring anc controlling programs on the 


remcete system via a local system*s Remote Supervisory 
Console (RSCI> virtual terminat» ODT» or application 
program Crequires SMCS on rewrote system). 


File Control: SYCOM verifies atl file transfers 
between two systeas. 


File Transfers: The transfer of certain types of files 
between a tocal system ard a remote systems in both 
directions. | 


Program~to~Program: Support of communication between a 
program running in a tocal system and a prograa@ running 
in a remote systeme <Atso» support a local application 
program communications Link to SYCOM itseif. 


Virtual Terminals: Provide a means by which a 

terminals ODTs or application program ina tocal systen 

can tecome a virtual terainal entity to a remote 

system. By designs» virtuai terminals assigned the 

status 0 Remote QDI if appropiatety declared as 

Server St ms in networkcontroiter when connected to 
n 


a S*cs 3 


Communications: Supports a full line of 
communicationss asynchroncuss synchronouss and direct 
connecte Line speed ts dependent upon Line Adapter 
capabilities. 


security: The SYCOM controls “log-on™ security» Logmon 
invelves checking a user*s security code and granting 
access to user files for transfer purposes. 


LINE THROUGHPUT 


Maximization of Line throughput 1s assured by a point~to~point 
message transfer porocedure which: 


A. 


Specifically acknowledges receipt of a message with the 
transmission of either arother message block or 4a 
"numtered acknowledgement" CZ#ACK) message. This 


reduces both line time and turnaround times 


Blocks records for transmissions Ci-e-» sends multiple 
data records per message blocke. a 


Comeress and expand blanks in data records. It is 


common for card input and printer output to have a 
Large number of isbecded blanks. Eliminating 


transmission of these btlenks significantly improves 
line throughput. 
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ERROR DETECTION AND RECOVERY 


The following features are providec in error detection/recovery 
areas to assure reliable service to the systes user: 


Ae A specific Nusneced acknowledgement. Ceither in the next 
message or in a #ACK) guarcs against the possibitity of 
a lost message by providing. an unagbi guous 
acknowledgement for the trérsmitted message block. 


B. The use of modulo 2 by the transmission nuaber ing 
: facility for the detection cf duplicate message blocks. 


Ce Dynamic reduction Cby cosmand) of the transmission 


message block size provides the potential for reducing 
error rates and retransmissions. 


“De The convention of different timeout values for local 
and remote systeas alleviate line ccetilision probleas. 


Eo The message block transfer procedure eliminates the 
ambiguous use of certain ASCII control characters (for 
example» | “ENQ" is used only during “establishment™s. 
and nowhere else). 


Fe Data transagission error detection is provided thru’ the 
use of vertical and horizontal parity in the systems 
hardware. 


LIMITATIONS 


_ The Systems Communications Module CSYCOM) is intended to provide 
a coatined systea of RJE» file transfer» prograa~to-SYCOM message 
transfer and terminal-to~prograa/program=to-prograrg comssunication 
capabilities. To provide these services and still aaintain a 
certain degree of compatibility with existing Remote Job Entry 
CRJE) systems» certain tisitations become inherent to the system. 
Therefores applicable limitations are defined as foltiows: 


Ae SYCCW does not» and will not» support Cassette tapes as 
an optionat peripheral device. 


8. In reference to “file tréensfers*» the iaplementation 

| currently in effect does not save» cr forwards symbolic 
file headers. Therefore» certain file characteristics 
would be Lost on file transfers between unlike systems. 


C. Program-to-Progras limitations involve an application 
program being assigned a2 “virtual terminal” position 
which reduces the nusber cf positions available for 
terminal attachsents. 


De Interactive application frogramas in a fremote syster 
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serving virtual terminals cn a local system cannot make 
use of “tailies™ or "toggles". 


Es The impiemented version cf SYCOM which this document 
describes» has only a Limited “file transfer recovery” 
capability. That is» any file queued to *PUT™ when the 
inter~system connection is lest» will initiate a_ file 
transfer operation frem the “heginningrteof-file™ at 
sycar BOJ after ccmmunications have been 
remestabtished. 


Fe The most noticeable Limitation is the fact that SYCOM 
only supports a single tire connection for RJE and Fite 
Transfer data communications at any one time. 


NOTICE 


The specifications of the software system described in this 
document are subject to change without notice. The avaittability 
or performance cf some features fay deperd on a specific 
conficuration of equipment such as larger memory or communication 
tine speeds. Customers should ccrsutt their Burroughs Saies 
Representative for details. 


ASSOCIATED DOCUMENTATION | P 


Some cf the details of the Systems Ccssunicatians edule system 
and its composite software elements gre contained in other system 
manualse Fotlowing is a list of associated documents referenced 
in this guide. Readers and users cf this dccument may refer to 
any or alt of these listed documents for additional information. 


Document Title Identification Number 

B1800/6817C0 SUPERVISORY MESSAGE CONTROL SYSTEM PeSe 2219 0482 

MESSACE CONTRCL SYSTEM INTERFACE | PeSe 2212 5447 

$1700 NETWORK CEFINITION LANGUAGE P.Se 2212 5223 

CCO/81700 NEL LIBRARY PeSe 2212 5215 

B1700 DATA COMP AUDIT PeSe 2212 5421 

61800/B1700 SYSTEMS SYSTEM SOFTWARE 1068731 
OPERATIONAL GUIDE 

Bi700 SYSTEM NETWORK CEFINITION LANCLAGE CNOL) 1073715 
REFERENCE MANUAL 

Bi700 SYSTEMS DATA COMMUNICATIONS 1089992 
INFCRMATION MANUAL . 

BURROLGHS CORPORATE DATA COMMUNICATICNS STANDARDS 1284 9006 

B1800/B1700 SYSTEMS KEMOTE JOB ENTRY CRJE)D 1090602 
REFERENCE MANUAL 

B1800/B1790 SUPERVISORY MESSAGE CONTFCL SYSTEM Preliminary 


SOFTWARE OPERATIONAL GUIDE 
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B1800/B1700 SYSTEMS REMOTE JOB ENTRY CRJE) 1090602 
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CONCEPTS AND FACILITIES 


GENERAL 


To elaborate upon the design concepts applied to SYCOMs the full 
range of system facilities are preserted in logical progression. 
First to be covered are actual system hardware configurations. 
This provides the base for further concept elaborations. Next» 
descriptions of the data comaunicaticn networks Involved and the 
relationship of a User System to a Server System are identified. 
Following this» implementation cencerts and functional aspects of 
the system are described. 


SYSTEM CONFIGURATION 


A User System criented to SYCOM utilizes a hardware configuration 
similer to the one shown in Figure II1-1 Cnext paged. A system is 
usually cosaprised of the followinc heraware elements: processors 
memorys OCT» cisk»s plus standard comsunication controls/adapters. 
Optiorally it can be equipped with an assortment of peripherals 
as per auser’s needs Ceege» card reader» card punches disk packs» 
tine printers magnetic tapes» etc» and terminals). 


The SYCOM program is responsible fcr managing availability and 
use of peripheral devices which are used for SYCOM functions. It 
also controls atl input/output operations for those peripheral 
devices as well as transmitting and receiving data files. (Data 
file is a generat term used here to enconupass all file types 
acceptable to SYCQM such as data» program source/objects» printer 
backups» etce) 


With this hardware configuration» "ell" SYCOM capabilities for a 
User System are initiated thru the systea ODT. An “extended” 
User System (configuration with local terminals) adds a new 
dimension to the SYCOM system in thet it"s capabilities are no 
longer confined to initiation frc#w the ODT but are now aiso 
available to Local terminats as weti. Commands entered from a 
systea COT can iritiate any SYCOM functions which includes 


establishing the Line connecticn for virtual terminal --.! 
Communications. Terminals ares however» restricted .to an-: 
explici® commend repertoire. CDetaits of.:-this concept are 


presented later in this sectione) 
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SYSTEM COMMUNICATIONS © 


Described here are the communications network aspects of a User 
System and its relationship to a Server Systea. SYCOM and ats 
associated Network Controtler support User Systems using either a 


point"to~point non-switched or pcint*totpoint switched network to 
a Server Systeme 


The data cowsunications procedure utilized is a subset of the 


Burroughs conversational point-to-poirt Line procedure. It is 
defined in a document entitied “Burroughs Corporate Data 
Communications Standards"*s refer tc “associated documentation”. 


That document fully describes the characteristics and functional 


oro 


BURROLGHS CORPORATION _ ¢& COMPANY COMNFIDENTI 


i ee a oe | we TAL 
COMPUTER SYSTEMS GROUP’ ~~ | | | 81800/B81700 SYCOM 
SANTA BARBARA PLANT : | Pe Se 2219 0456 CA) 
attributes for a non=transparent half-duplex mode — of data 


commurication to which this system subscribes. 


PCINI“TO<POINT SWITCHED NETWORK 


In @ switched network environments a User System communicates 
with 2 Server System without requirirg dedicated communication 
Lines; see Figure II-2 Con the follcwing page). The computers 
are ccnnected ty telerhone Lines to the common carrier exchange 
servirtg their respective locations. A temporary connection (data . 
path) is established between the cogcuters only for the period of 
time in which data transmission is actuaily required. The 
connection is established by dialing the telephone number of the 
Server System. Usually the dialing procedure is manual» however» 
SYCOM can cause this function tc te done automatically upon 
command directive. : Ys 


In switched Line networks» a Line refers to a discrete data path 
between a Server System and the User System Cincluding terminals) 
thru the commer carrier exchange. The services provided by this 
commor carrier are usually on a timecused basis. 
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Figure 3-22 Point-to-Point Switched Network 


POINT*T0<POINT NON“SWITCHED NETWORK 


A paoint~to~point non=switched networks as shown in Figure II-3 
Chelonds consists of a private or lezsed communications line that 

conneets the User System with a Server Systeme. In this networks 
the computers are physicatly connected» that is» the circuits 
making up the coamunications Line are permanently established» 
and data may be transmitted over the tine at any time. No 


aAsaele: ~- sa =~an ama #he a Suma am & ma ees nal 
qgiarttig a Youu cu aus Libis tye wl PTOLaHAVEI Keo 
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Communication lines in a nonvswitched network are alternately 
known as privates teased» or dedicated linese In this document 
they sre referred to as “dedicated lires*™. These Lines may. be 
privately owned Ceege» internat cirect ‘connection in the same 
physical location)» or provided by a common carrier on. a contract 
basiSe This dedicated connection between two specific Locations 
would provide a Line for exclusive ay eee. eee 
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Figure 3-3: Point-to-Point Nen=switched Network 


CCMMUAICATIONS PROCEDURE 


With the conversational point~to~poinrt commurications procedure 
assumed by SYCOM» inherent provisicrs include the capability to 

"reverse™ message block trarsmissiors without . having to tnvoke 
An ARaAttn Ras 


separate establishment and terairaticn procedurese The essential 
characteristic of this capability is its ability to specifically 


“, “acknowledge™ receipt of..the. previous message block. This 


“Ca écomp lished. ‘by including: a special acknowledgement character : 


the header of the "*next™ mess.age bet k transmitted. . This ee 
chareécter is the Acknowledge Receivec Message CARM) character. 


The usefulness of the ARM character is twofold: First» it 
provides a specific acknowledgesgent to the receipt of a previous 
message block by utilizing the “numbered ACK" facility. 


Secondly» when the receiving system receives a message block that 
it céennot accept (no buffer space or a specific peripheral is 
not~ready )» the ARM character persits an tapticitt NAK of that 
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message block. This is achieved by transmitting the NAK in the 
next cutgoing sessage blocke : 


USER SYSTEM - SERVER SYSTEM RELATIONSHIP 


Referring to Figure II-4 Cfollowing paged» the User System is 
viewed as the system in the network which serves as a point of 
data collection and data distribution. For examples RJE type 
card inputs» card output» tine printer output» and/or terminal 
input/ output messages- 


A Server System on the other hand is generally considered to be 
the deta processing systeu>, often referred to as a Host Systea 
or Centrat System. It nofmally receives large volumes of data 
from 2 User System to be processed cr program source files to be 
compiled. In the case of program coapilationss the printout and/ 
or prcgram object code files can be transmitted back to the User 
System Cupon request) for printing or possible program execution. 
Interactive output is returned directly to the isthating progras 
or terminal via the Network Controllers. 
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The actuat physical size of a computer however» has relatively 
Little importance when considering a system as a Server System. 
The B1800 can be either a User or Server System» depending on the 
scope of the services provided at the time. It can atso bes 


under certain circumstances» 
Syste at the same time. 


~SYCOM AND ITS ENVIRONMENT 


HARDWARE REQUIREMENTS 


bott a User System and a Server 


The following List of equipwent must be present for SYCOM system 
operations. However» the listed equipment is not dedicated to 
SYCOM Cor supporting system software) and is available for use by 


other programs. 


Hardware Type 


B1800/81700 Central Processor 
9@8 KB Main Memory Cminivgun) 
Seconcary Memcry Cdisk storage) 
Ciee» head“per~track» pack) 
120 or 132 Position Printer. 
80 or 96 Cotiuan Card Reader 
80 or 96 Cotugsn Card Punch 
Systems OOT COperator*s Nisplay) 
Single or Multi Line Control 
Line Adapters as Required 
Cleased» switched» direct) 
Data Sets and Cables 
Cas required) 
TD820/TD830 Tersinals 


MEMORY REQUIREMENTS 


Usage 


Systema Control 
Systema Software 
Progras/Data Files 


- Line printer output Coptionat) 


Certrot/RJE Type Input Coptionat) 
Control/RJE Type Output Coptional) 
MCP/SYCOM/SMCS Operations Coptional) 
Systena/Terminat Communications 
Systen/Terminat Coamunications 


System/Terminal Communications 


As Required Coptional) 


Provided here is a list of Systea Software elements and their 


associated memscry requirements. 


They can be used to approximate 


memory requirements for an interactive B1800/B1700 SYCOM systems 
operating with or without a Superviscry Message Control System: 


= 64.0 KB Master Control Program (MCP). 

= 15.0 KE Network Controtter Cbhasic). 

- 3-9 KB Each additionat Line in the Ccntrotter. 

- 16.0 KB Supervisory Message Control System (SMCS). 
- 18.0 KE Systems Comsunicatiors Module (SYCQM). 

- 22.20 KB Command AND Edit system CCANDE). 

= 22-0 KE Each additional terminal logged=on CANDE. 
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After determining the basic memory requirements for the systems 
additional mesory must te includec for any other programs that 
afe tc be executed in conjunction with SYCOM. (See appropriate 
reference manuals for those memory requirement estimatese) 


SOFTWARE REQUIREMENTS 


In order for SYCOM to become cperaticnal» certain system software 


elemerts gre requirec.e Although these elements support’ the 
operation of SYCOM» they are general purpose and in fact support 
the ertire systeme Each software element identified here is 


individuatly cocumented for its capabilities and requirements. 
Following is a list of those pertinert system software elements: 


- Master Controt Program (MCP) 


- SYSTEM/MAKEUSER program Cif “*usercodes™ are used) 
- Network Controller prograa 


MASTEF CONTPOL PROGRAM CMCP) 


The MCP is an operating system which manages the demands’ and 
resources of £1800/81700 systems. It reduces programming efforts 
by prceviding 4 family of commonly neeced furctions and = services. 
The WCP requires strict user adhererce to pregram structures and 
procedures in order that there may be communication between the 
different programs» interpreters» ane the MCP itself. 


Its primary function is to optiwsize the productivity of a system. 
External intervention is held toa a sinigum, and maxi gum 
throughput is achieved by incorporating into the MCP the primary 
tasks of Input/Output C{/0) centrols file handling» 
multiprocessing» interrupts» meacry altocations aopltlication 
programs» and operator interfaces. 


SYSTEM/MAKEUSER PROGRAM 


A utility program that is used to creates modify» and access the 
syster*®s “usercode™ fite. This fite contains ait vatiid systea 
usercode/password combinations. These usercodes“passwords are 
mainteined in a file named “CSYSTEM)/USERCODE™. With this file, 
the MCP can supports and enforces» a4 file security mechanism for 
disk files and programs/users that access ther. 
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NETWORK CONTROLLER PROGRAM 


The Network Controller is a Netwerk Definition Language CNDL) 
type program whose prime function is to process and supervise the 
flow cf messages between systems» terminals» and programs. It 
performs all data communication Line discipline functions which 
are necessary for proper line/terminat control. The Network 
Contrcller handles the initiation anc completion of communication 
I/O"s and services exception conditions. In order to optimatty 
provide these functions» the Network Controller is configured» by 
NOL generations to the specific needs of the system on which it 
is to be runs Cieew» the number and type lines» number and type 
tersirals» €tce)e A product of this generative process is the 
Network Information File CNIF). This file centains all tersinal 
and communication Line attributes zs well as Logical aspects of 
the ccm@unications network. 


Basically» this Controller enables sessages to pass between it 
and SYCOM as well as other terminal criented programs executing 
in the system. This is accomptishec via MCP supported Remote 
Files and Queue's along with the Certroller's message switching 
capability. Each progras that is tc be part of the message flow 
must contain a “remote file” for input/output message traffic and 
it sust be known to the Network Contrctlers this includes SYCOM. 


SOFTWARE OPTIONS 


The following software elements are rot required but may be used 
in conjunction with SYCOM to service a particular user's needs. 


- Supervisory Message Control System CSMCS) 
- Application Prograas . 
- CANDE Program Caultiple~user text editing) 
- ODMPALL Prograr 


Although the Supervisory Message Control System is not a required 
systems software element for the operation of a SYCOM system» it 
is definitely suggested for those systems which have terminals. 
A Terminal in a SYCOM system envircnsent is permitted to initiate 
efile transfers" or become a “virtual terminal™ entity on a 
Server Systeme Additionally» these terminals may be utilized for 
other applications such as data ertry and program development. 
To saintain overatt control of the terminals in these’ varied 
Syster environsents» the SMCS becomes the controlling etement. 


SUPERVISORY MESSAGE CONTROL SYSTEM CSMCS) 


The ‘Supervisory Message Controti System CSHTS) is intended to be 
the “supervisor” for a data communications software system which 
incluces such Burroughs software eleeents as “SYCOM"» CANDE» and 
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other ontine programs of either Burrcughs or customer origin. 

The SMCS provides to an interactive system» many functions and 
special features. To fully explecre its capabilitiess please 
consult the "SMCS Software Operatioréet Guide". However» the 
highlights of some cf the more pertinent functions are presented 
heree Relevant to the SYCOM systes» SMCS provides some hasic 
message switching Cterminal to termiral» terminal to ODT» and ODT 
to terminal)» attachment of termirals to application programs via 
a remcte file» and information abcut the system's network. 


Additionally» it controts terminal log-on security Cchecking of 
user security codes and granting éccess tc user files) and 
approves Cor denies) alt remote file opens to terminals under its 
contrcl. Moreovers SMCS provides é€ certain degree of resource 
aliocéetion. Ey this is meant» thru security» job control» remote 
file controt» and error handling» the SMCS can allocate some of 
the systems resources. For exanples for every terminal under its 
contrects» SMCS has final control over that device as a resource. 
It céen therefore, temporarily “ettach™ terminals to SYCUM by 
means of the SMCS “SIEN ON® facility. 


APPLICATICN PRCGRAMS 


Effectively there are three types cf application programs useful 
to the SYCOM system user» they are: 1) Interactive data entry» 
2) system~to~sSystems and 3) commard input ta SYCOM. Each program 
type is briefly described here with details of now they actually 
work presented in the following “Functional Description". 


A user can esiect to develop an “irteractive™ application prograa 
tailored to specific needs of an installation. These specific 
needs could irnctude such apolicational functions as data entry» 
information retrieval» or any application desired. 


If there is a requirement for an application program in a User 
System to comsunicate directly with srother application progras 
in a Server Systems the capability is there. This communication 
fink is directly thru the Network Cortrollers and SYCOM has no 
role in this message traffic. SYCOM does howeverr initially 
approve a “virtual terminal" isn for tcentification and centrol 
purposes. This is a residual capability based on requirements 
for ketwork Controllers by SYCO4. 


The third type of anplication prograa provides the source for a 
§trine. of SYCOM commands to de performed on an automatic. basise 
Norrwetly this would be for cff-hours cperatior but could also be 
utilized for common everyday occurrences of a work flow pattern. 
CAn exanple of this would be the “SLAVE/BACKUP* program.) 
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FUNCTIONAL DESCRIPTION 


GENERAL 


The operation of SYCOM is dependent upon support from a Network 
Contrecller precrame. This Network Certroller provides interfacing 
Links between SYCOM ana the communications hardware (terminals 
and cther systems). The controller furnishes those services and 
capatilities which are outlined in ceneral with the preceding 
subjects» “Software Requirements”. Throughout this descriptions 
Network Contrcller functions are elaborated upon where it is 
necessary to maintain continuity of subject matter. Conctuding 
this sections functions of a Network Controtter are outlined. 


Functional features of the system are described in the following 
order: 


1. Standard RJE 
2- File Transfers 
3-e Virtual Terminals | 


4. Program~to7Program Communications 


c 


Se Network Control 


The Virtual Terminal capability contributes Terminat~to~Program>, 
Terminalto~SYCOM anc Remote Sunerviscry Console communications. 


STANDARD RJE FUNCTIONS 


The SYCOM program controls» at a secendary level» all typical RJE 
peripheral devices of a User Systeme It reads and punches cards» 
prints outputs accepts ODT input» cisplays ODT output messagese 
and transfers file/control messages tetween the User System and a 
Server Systeme 


Input can be directly from a card reader» from tape or disk thru 
file eauates» or from the OOT. . Cérd reader input is generally 
associated with RJE batch data transsgissions; whereaS Maanetic 
tape and disk input more directly retates to file transferse 
Howevers these operatians in SYCOM are considered synonyaous. 


Commands can be alternately input frcem a specifically designed 
application program thru the *Progrém~-to~SYCOM" facility. With 
this mechanisa» the RJE input as weil as associated output could 
be autormaticetly controtled on a caily basis without requiring 
the system operator to enter a long series of commands to SYCOM. 


— 4-2 


BURROUGHS CORPORATION : COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1800/B1700 SYCOM 
SANTA BARBARA PLANT Pe Se 2219 0458 CA) 


Output can be made directly to a carc punche line printer» disk» 
Magnetic tape» or ODT.~ Howevers in the case of a printer or card 
punchs the data received can be in the fora of a “backup. file” 
which is first written to diske Subsequent MCP commands are 
entered to cause printing or punching as appropriate. 


Furthermore» SYCOM gives certain directives to the Network 
Contrcitler such as requesting it ta establish or revmestablish a 
connection to a Server System. SYCOM also causes the controller 
to enter an *idle™ state while waitirg for an incoming connection 
to be established and to terminate a connection when appropriate. 


The transgsission of RJE data files tc/from a Server System occurs 
as follows: A user of the User System prepares a card deck for 
trans#isston to the Server Systese The cards are read» 
compressed and blocked by SYCOM Cupon command) and written into 
the Network Controiler*s remote file. (See writeup on “Queue 
Depth Controt".) The controtter begins imaediately to transmit 
these card images Cmessage blocks) to the Server Systea. This 
process continues until all cards have been read and transmitted. 
The card files known as a “job streas"» is then under control of 
the Server System's MCP which processes that job stream as per 
directives included in that file Ccospife and/or execute). 


ALL GOT type sessages which pertain to that job (BOJ» EOJe and. 
GOT messages) are transmitted back tc the User System for display 


on the User ODT. Messages can be entered via the ODT to control 
jobs executing on the Server Systes or manipulate data files as 
requireds providing a MCS is running in that system. SYCOM 


accepts these messages and writes them to the Network Controtlter 
for transmission to the Server Systes and subsequent processing. 


When the job has finishede any associated tine printer and card 
punch output created at the Server System is transmitted back to 
the User System. (This is dependent upon the software systea in 
the Server System? HOST/RJE does this automatically where SYCOM 
does note) The Network Controtler receives these incoming message 
blocks and forwards them to SYCOM via SYCOM*s remote file Cinput 
queue). SYCOM then appropriately prints and/or punches this data 
on a User System peripheral device. 


The above described process describes the flow of data between 
the User System and a Server Systems often referred to as a “job 
strear". Any nurmber of job streams may be initiated at the sage 
time Cmultiple Server Systes MCP directives contained in one job 
file) froa a User Systea. The nuaber of jobs which can or will 
run ona Server System is limited only to its capabilities to 
process theme 
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FILE TRANSFERS 


File transfers are supported for both disk and magnetic tape 
devicese Files may be transferred between any combination of 
these devices. Magnetic tape transfers are restricted however» 
in that onty ane file ner tape may he transferred. Tapes created 
by the LCAD-DU*Ps» SYSTEM» and COPY functions are not supported. 
(These tape files are first Loaded tc cisk and then transferred.) 
The data communications protocol allcws transfer of only. one file 
at 2 times im each direction. 


Whenever SYCOM is operating with a ccnnection to a "ASCII" system 
such @s a B800»r the following three File Transfer rules apply: 


1) Code files are ghiways encoced> 


2) Data files are not encoded» non~graphic characters are 
replaced with question mwarks “?"s and 


3) Non-graphic characters in cata files can be transferred 
intect by soecifying T8INARY" in the COPY command 
string. This forces erccding cf the data file 


specified Catl records). 


The user initiates a file transfer ty entering a “COPY” or “ADD* 
commang to SYCCM CPUTs» RPUT» RFETCH and FETCH are acceptable 
alternates). The syntax allows source and destination systems to 
be specified CPUT» RPUT» RFETCH anc FETCH excluded) for the 
transfer via attributes. These source and destination system 
jidentifters must be the same as those specified in the 
"system~id” control message at connection initialization time. 


If the specified source system is the User System» the transfer 
is a “PUT™s which is a transfer of a file *to" another systema and 
is based on SYCOM*s “SYSTEMID*® parameter. When the source system 
is a Server System» then the transfer is a "FETCH"s which is the 
transfer of a file "froma" another systems also based on SYCOM's 
"SYSTEMID® paréemetere 


The actuat transfer of a file is initiated by exchange of control 
information tetween systems? this process is often referred to 
as "handshaking". All file transfers ogcur as SPUI"s"~- That ise 
1f one system wishes to do 2 "FETCH™» it sends a “Fetch message” 
to the other system. This causes the other system to initiate a 
"PUT™ sequence by sending a “Put Message” to the initiating 
syste. PUT and FETCH messages coacletely specify both source 
and destination file attributes. The PUT message elicits a "Put 
Reply Message"» signifying that data transfer may begin. The 
sender system then sends one cr acre data message blocks which 
are eventually fotloned by an endrof-file message. 
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Upon cosptetion of the file transfer» the system that received 
the file informs the originating system of the completion. This 
notification is made with a “user“destined controt message”. 


If either system wishes to abort an in~process file transfer Cfor 
any reason)» that system sends either an “Abort Put™ or “Abort 
Fetch" system control message to the other systen. An abort is 
initiated by the appropriate command entered to SYCOM. Alternate 
"device not ready ~ suspend” and “device ready - resume” messages 
are used for flow control at any time for teaporary stoppages 


A file transfer request that cannct be processed when entered> 
because another file transfer is in progress» is queued to disk 
and . processed when next possible. Although there is a maxinuan 
depth to this disk queue Csee “Restrictions")» it is sufficient 
to handte all but the most extreme casese This feature prevents 
request rejections due to the fact that only one fite transfer 
Cin each direction) can be inwprocess at any given time. 
Requests are queued on a first come» first serves basis. This © 
mecharisa assures an orderly processing sequence. 


MAINTAINING INTEGRITY OF FILE CHARACTERISTICS 


A goal of the file transfer mechaniss is to maintain as many of a 
file*s characteristics as possible throughout the transfer. For 
exaseple» if a COBOL source prograas is transferred» it should be 
capable of being compiled» without further sodification» on the 
receiving system. Likewise» if a program code _ file is 
transferred to a “like system"s»s it shculd be executable without 
modification. 7 


Specifically» tf a file is transferred between two like systems» 
even if via one or wore unlike systeass» all file characteristics 
must ke preserved. fea accosplish this» a symbolic version of the 
file*s header Cunderstandabte to all systems) is transferred with 
the file. This symbolic file header is the *PUT~OR“FETCH“RECORD® 
as defined for SYCOM file transferse It is prefixed in the data 
streagr by a beginning-of~header cantrol message. 


In the receiving system» when a symbolic file header is received» 
as many as possible of the file characteristics are incorporated 
into the file being created/received. If the file is transferred 
to an “untike™ system» the syabolic file header and the original 
System type are saved with the file» to be forwarded with the 
file whenever it is again transferred. If the fite is 
transferred to its original system type» the entire symbolic file 
header is incorporated to § create a file identical in 
characteristics to the original file» and the symbolic header is 
not saved. . . 


When a system sends cne of its own files» it must include in the 
symbolic file header» enough inforgation for it to recreate that 
file if returned. If this file is returned» it must be sade to 


pe 
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fook identical to the ortginal file» with the exception of "file 
name™ (this is conveyed in the symbolic file header). 


An untike system created file may be changed cr replaced tocaltly>» 
thus invalidating the saved syabotic file header. In this case» 
the symbolic file header describes the file according to its new 
creation system type. 


Note: The "symbolic | file header" discussed above is not 
implemented in this version of the system software. It 
will» however» be availabte ir a later release. 


VIRTUAL TERMINALS 


To the SYCOM system» a “virtual terminal” can be either a local 
termirals the system ODT» or an application program. Therefore» 
virtuzi terminals is a togical capability whereby a message path 
can be established between a terminals ODT» or program on the 
User System ard an appropriate interactive application program in 
a Server System. Additionatly» utilize the inherent capability 
of cortrolling jobs in a Server System with a special MCP command 
repertoire. Basically» on the Server System end» this becomes a 
reality -thru the capabilities of the SMCS. However» the main 
intercsystem connections are established by SYCOM which makes it 
possitte. Refer to Figure 47-1 for a pictorial overview of a User 
Syster with virtual termirals. CiInteractive application programs 
can te any program using a "remote file” but not using “tallies* 
or “taggles™.) 


The terminals are virtuai in that ali User System facilities as 
welt as ail Server System facilities are available to the system 
uSsefre User System commands are local and are therefore» 
processed within the User System by either SYCOM» SMCS» MCPs or 
application program. Server Syste input messages are accepted 
by the User System ard transmitted tc the Server System Cvia the 
Network Controtlers) for processirg and subsequent reply 
messagese | : 
In view of a “virtual terminal” in an interactive environaent» 
Server System commancs must be forwarded as socn as possible. To 
effect this requirements SYCOM has the capability te "interleave" 
a “user destired control message" into the data transmission 
strear Immediately i1f a file transfer is In progress. The 
contrcl message which contains the virtual terminal message is 
immediately transmitted or an incividual basis to the Server 
systenme 
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TERMINAL-TO-PROGRAM COMMUNICATIONS 


When SYCOM is utilized in a larger ‘system development or data 
entry environment Cwith terminals)» then the User System depicted 


in Figure 471 on page 4-7 is applicable. In that 
hardware/software configuration» the comptete spectrum of SYCOM 
capabilities are availabte to the system user. To be amore 


specific» in addition to the capabilities previously identified» 
a tervinal-to™prograr capability is available to the terminal 
usere : 


BURROLGHS CORPCRATION 


COMPUTER SYSTEMS GROUP 
SANTA BARPARA PLANT 


47 


COMPANY CONFIDENTIAL 


B1800/B1700 SYCOM 
Pe Se 2219 0458 (A) 


f | i f/f  ODT/RSC 1 
<< Virtual j <> Mirtuat of. 
\ Terminal 1 \ ° Terminal. 1 
\ / 
\ 7, 
The User System X / 
ON / 
= am ae neuen enone ame ee ee ! aga new anasto ne 2 ew See ! eee 
{ {— i 
jo tte eese= weer em n mmm memes see se 0 em n een enero ne ' 
1 4 1 i - i 1 fo 
' ¢ -SMCcS [sss 1 Network Controlter t=--c-37f MCP it 
{ 1 i ! i 1 ! 3 
|. HSER eTSee . StPseTSsereSoeseesesaess - er eoeaee esas 
{ | I i 
i | i t 
lL Ses ese = Ses ee eS a eS ii. , Sesser sss ss+ssss= oo = 5 
| ! { 1 ! ! 
i 4 SYCOM feewnmmocrmn---! Application Program 1 
if ] 1 { (CVirtuat Terminat) f f 
{ SSS t ese e Ss tee ese = i i. | 
1 Une eese desea c nn ese sewer en od 
{ | i 
ween ewes ewe ew we Bs ewe e wees ee ]. SQ wame® naan wana wZ an awe aedan Oe ee en ee eo ew w 
/ 
/ 
/ 
4-~/ 
/ 
/ The Server System 
/ F 
eee es ee ee ee Pe ee ee ee | eee te mace nw emma seem wens ans ioe te cpa da 
1 1. | 
foo sete ctecen= 0 seen wenn nnm enn eest tere se 0 ewe eneeenen--- i 
it \ 1 | 1 { Fd 
i $f sscs [----- 1 Network Controller J-~7---!t MCP 1 3 
I l f 1 1 ys | j 
! ww eS on ee ee ee oe eee eS ee Sr ee ee eer ee eee 
1 | i 
] an aQn2eaonen ana anwaeann ae earns - aires ares Stes eee oe eee wee sem eee n= 
1 of amt t . i i ee ee ore 
i; SYC.CM Ccdonsisecv. To Application Program | 
] aa Seams nee ea Bea se eaan ee 
] 


Figure 4-1: 


Virtuat Terminat Schematic 
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In this environments SYCOM stitl ccsmunicates directly with the 
Network Controitler for normal coagunications activity. However » 
the S¥YCS maintains elementary control cver SYCOM and control over 
a system's terminals. To clarify this» the SMCS directly causes. 
the execution of SYCOM when a terminal Cor RSC) “signsson" to 
SYCOM thru the SMCS. A terminal user can ther direct commands to 
SYCOM in the User System or the SMCS in either the User or Server 
Systeme Exactly which commands and how the directives are given 
is covered in Section V> “Terminal Operations". Note that these 
capabilities are also available to the user who optionatly elects 
not to utilize a SMCS in the systes. (Refer to Figures 475 and 
4°6 for configuration overviewse) 


With the introduction of the SMCS software element into a system» 
atl of its coamands» functions» and capabilities becoswe available 
to the terminal user. CRefer to the “SMCS Software Operationat 
Guide" for details and capabilities.) 


Before proceedings it might be helpful to this discussion for the 
terms User System and Server System to again be clarified. A 
User System is the cosgputer on which there are terminals/users 
wishing to engage in interactive computing sessionse The Server 
Systes is the computer that supplies those interactive services 
on a dewgand basis. CRefer to Fiqure 3-4 previous section.) 


The ccausunications protocol assumed ty SYCOM supports User Systen 
terg@inats connected Ctlogicatly) tc an interactive application 
prograga on a Server Systea. Using this protocol s,inimizes’ the 
visibility of interfacing software elements so that to a users it 
appears as though the terminal is connected directly to the 
application prograne The tersinal is then used as if it was 
locally attached to that program Csee “Message Path Assignments* 
further on in this section). 


Presently available interactive application programs aay be used 
or the user can optionally elect to develop a special application 
progres for terminal and/or other program interaction. 


The method for conveying terminal data between two systems makes 
use of the “device address” field in the control message. This 
message specifies the terminal with which the message text is 
associated. The device address in the context is termed “virtual 
address"» and is the name used by both User and Server Systems to 
reference a particutar terminal. This addressing scheme fotlows: 


Ae The cevice address is comprised of two characters? one 
- upper case and one tower case atiphabetic letter. 


EB. The User Systes “transsits” a virtual terminal address 
as lower case/upper case tetters-e- When it “receives” a 
response message from the Server Systems the terminal 
address letters are reversed upper case/lower case. 
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Cs The Server System "receives" a virtual terminal message 
with a device address cf lower/upper case letters Cas 
transmittec by the User System). The virtuat terminat 


addressing scheme ther frecuires the Server System to 
"reverse”™ these device address characters prior to its 
transmission back to the User System. C¢These transmit/ 
receive device addresses are specified in the Network 
Controller's NDL generéetion process; on *"bath™ 
systems.) 


C. Assume that a User System supports a connection for 
five terminals to a Server System. The User Systea 
refers tec these ternirals by virtual terminal 


{transmit) address: 
aAs tA» cA» dA» and eA 


The Server Systewa atso refers to these same terminals 
by virtual terminal Ctranswit) address? but» as the 
Server Systems rote is reversed» its trans@it address 
is also reversed. For exasple: 


Aas Abe Ace Ade and Ae 


The following events represent the terminal-to~program procedure 
amplerented ty SYCOM. These everts portray an tnteractive 
sessicn between a virtuat tersinat cn a User Systen and an 
application program on a Server Syste. 


The User System 


At initialization time» SYCOM issues 2 “remote file information” 
request to obtains from the Network Contrcttler> the Logical 
Station Aumbers Clisn*s) for the virtual termirals assigned to the 
SyStefe These nuabers sre placed irtc a table which maps” the 
actual "“tsn™ of each virtual terminal into a virtual *tlsn”™ with 
which SYCOM can reference the corresfonding virtual terminal. 


When € user wishes a connection to a Server System» a “.CONNECT® 
ccmmand is entered to the User System's SYCOM. SYCOM finds the 
"next" avaitable entry in its “*virtuet tsn tabie*™ and transa#its a 
"connect message” to the specified Server System. This control 
message contains 3 virtual terminal zddress- Upon receipt of the 
“connect reply message“» SYCOM replies with the results. 


Durinc the life of a connections alt data messages entered from a 
virtuel terminal are sent to the Server System for processing. 
CExcluded are any tocal SCS commands which are prefixed with the 
assiored signat character.) This is accomplished by doing a 
remote file write to the Cecntrotter using the terminal's virtual 
terminal “tsn". In processing this sessages the Controller maps 
the virtual terainat isn into the assigned virtual terminal 
adaress Ctwo characters)e The message is then transmitted to the 
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Server Systea- according to SYCQW ¢crotocol» with the virtuat 
terminal address. The terminal user can then “sign on” to any 
application program that is supperted in the Server Systems 
providing the capability is inherent in the form of a MCS. 


Any incosging wessage to the Network Controlter from a SYCOM Line 
which contains a virtual terminal adcress Ceeges "Aa*» “Ab*» etc) 
is sert to SYCOM. These messages are written into SYCOM"s remote 
file CLINK) by the Controtler with 2@ device address appropriate 
for the terminal. SYCOM upon readirg the message» searches the 
virtusl terminal address table fcr the actual system “tsn" for 
that terminal. SYCOM then puts the actual “lsn* into the reply 
message and writes it into the Network Controtler*s remote file 
Cstation queue) for distribution to the originating terminal. 


In the case where the virtual terrinal is. actuatly an application 


progqrzm» the reply message is sent te that program via the queue 
mechanism for “prograa~tosSYCOM* comsunicationse 


Hhen the user wishes to disconnect from the Server Systems a 
".DISCONNECT™ command (C(.BYE command or *0FF command may also be 
used) is entered to tocal SYCOM which transrits a “disconnect 
message” to the Server System» specifying the virtual terminal 
address to be disconnected. The terminal is notified of this 
action and is then free to establish another connection or work 
pattern as desired. 


The Server Systea 


The Server System*s Network Controller intercepts “connect™ and 
"disconnect™ wessages Cunlike alt other contral msessage which are 
routec to SYCC#). On receipt of a “connect message"» the Network 
Contrcttlecr verifies that the addressed virtual terminal exists» 
checks to see if tit can support another connections and that soe 
interactive application program ts ready to accept input froma it. 
If alt is correct» the Network Cortrotller returns a “connect 
reply message” indicating successful coapletions etse the 
Controller sends back an error response in a “connect reply 
message” , 


When the connection is successful» the Server System makes this 
virtual terminal appear as a terminal local to that systea. If 
the user is “"lLogged-on™ to SYCOM» ther that user is automatically 
"Logged~on™ to the Server Systea*"s SCS. 


During the Life of the connection» ary input data received by the 
Server System's Network Controtler for an enabled virtual station 
is conveyed to the waiting applicaticn programs thru its remote 
file Ccautd te the SMCS). This wessage transfer transpires in 
exactly the same wsanner as for tocal terminals. Any output data 
generated by that application progrés is transaitted back to the 
User Systea» with the virtual terminat address specified. 
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The Server System upon receipt of a “disconnect message» takes 


necessary action to detach that virtual terminal and respond to 
the User System with an appropriate “disconnect reply message”. 
If the user was lLogged"on to the Server System's SMCS» then that 
user witl be automatically “lLegged-cftf" the virtual terminal. 


Se NF Ser ee ee 


REMOTE SUPERVISORY CONSOLE CRSC) 


It is an inherent capebility of the system to utilize the ODT» an 
application programs or a terminal in a User System as a “Remote 
OOT" to a Server System. This onty occurs whens as Figure 4-2 
showss a copy of the SMCS 1s runnire in the Server Syste. For 
this systems the CDT is also referred to as a “Remote Supervisory 
Console» or simoly the RSC. This term was selected to imply 
capabilities which transcend norwsal capabilities of a ODT. This 
interface infers communication Cvia the SMCS) with a Server 
Systeg's MCP» hence the tera» Rewote Superviscry Console. 


Messages input from the RSC to SYCQOM are grouped into two basic 
types:~*Local SYCOM and Reacte MCP. Local SYCOM input includes 
commands to initiate file transfers» request SYCOM status data» 
ard cther such functions. Additionagtty» respond ts conditions 
within SYCOM"’s domain that cannot be preprogrammed> such as card 
reader not reacy» clear peripherals»p etcee 


Remate MCP cornmands permitted from a RSC are basicatly directives 
used for controt over the execution cf jobs in the Server System? 
all via the Server System's SMCS. Onty certain MCP commands are 
permitted from a RSC Creference Appendix Fes “Restricted MCP 
Command Summary”) when the RSC*s “virtual terminal™ assignment is 
not declared as a Remote ODOT in the Server System's Network 
Contrcllers ctherwise» only Remote CDT restrictions apply. 
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GQutput messages for RSC aisolay can be grouped into four typess 
they ares Local SY€OMs» Local MCPs Remote SMCS» and Remote MCP. 
Locat SYCOM outout messages are rermeally responses to comaands 
but can also be error type messages reporting SYCOM probtems. 
Local MCP outnut would include such messages as "NO PRINTER 
AVAILABLE" and other such informatior wessaces which pertain to 
operations of a SYCUM system. fFemote SMCS messages would be 
replies to SMCS commands entered far processing by the Server 
Systerm’s SMCS. Rewote MCP output messages include ODT type 
output resulting from jobs run on a4 Server Systeme These 
messages are routec back to the User Systea@'"s SYCOM program for 
display. . — 


In the case where the RSC ts actually an application programs the 
resporse messace is directed to that program via SYCOM*s “program 
to SYCOM™ queue mecharism@e 


Referring again to Figure 4=2»5 assu@e for examples that a user 


wanted to execute a job on the Server System. Assume also that 
the subject program and all data recuirements reside 1n- the 
Server Systeme The appropriate comawand string is entered to the 


User System*’s SYCOMs» via the ODT/RSC. SYCOM accepts this message 
from the MCPs formats and transmits it to the Server System> via 
the Network Controller. (The cogsand string could also be 
entered from either a tlocalt tersirat or application programs 
Although these message paths are slightly different» the end 
results are the same.) 


In the Server System» the SMCS receives the MCP command message 
Cfrom the Network Centroller) and “zips” it along to the MCP. 
The Server System's MCP processes the request as asked. Atl 
output messages pertaining to that job are given to the SMCS 
which in turn initiates transmissior tc SYCOM in the User Systen. 
User SYCOM then displays these messaces on its ODT/RSC. 


From this we can see SYCOM"s involvewent and the processing flow 
involved in this type of operaticar. Atl preceding functions 
described for the RSC are over and above the standard User ODT 
input/output messages used for normal User System operations. 


Since SYCOM is symmetrical» both systems can perform an identical 
set of furctionss providing of courses both systems are of the 
gseme seriese Actual input and output messages are exemplified in 
Section V» “System Operating Procedures". 


PROGRAMTO“SYCCM COMMUNICATION 


The seme range of functions are fossitle for the Program=to-SYCQM 
facility as for Terminal to7Program Communications. This feature 
is made possible by an adaptation of the Terminal-to~Progran 
SChHeaMEs 
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A mechanisn Cof iupleamentation dependent nature) is provided to 
allow an application program in the User System to masquerade as 


a “terminal”. This application program sust format messages 
preceded by the program header to appear as if they were terminal 


keyboard inpute These messages are then written into SYCOM's 
“"SYCOM/OUTO" cueue for processing. 


Frog this point on» at least until a reply message is returneds 
processing for SYCOM is the same as tersinal-to-program commands. 
When SYCOM produces a reply message» it writes the message into 
its “SYCOM/INQ* queue file from where the application program in 
turn reads this gueye to obtain the sessage- These reply 
wessages are formatted to terminal display speci fications. 
Therefore» the application program can either print» store» 
ignores parse» or disetey select message text as appropriate for 
the programe 


The schewatic on the following page CFigure 4-3) provides = an 
overview of the mechanics for *Programto~SYCOM Communications”; 
Commurication between the applicatior programs and SYCOM jis’ thru 
the previously identified pair of “queue files". The application 
program gives a command to SYCOM by writing into SYCOH"s input. 
queue file nased “SYCOM/OUTQ"™. The application program obtains a 
resporse message by reading from SYCOM"s "SYCOM/INO” queue. file. 


Message Formats used for “*Program~toa"SYCOM" communications are 
defined in Section VIIs "Appendix E". No command restrictions 


are enforced for this method of SYCO#M/systes control. However » 
this feature is controlled by the SYCOM parameter "PROGRAM" and 
for this function to be availabie>s that pardmseter “must be* 


specified when the “SYCOM/PARAMETERS" file is created. 


The SYCOM command “PROGRAM™ may be used to interrogate the 
current value of the PROGRAM paraseter. If it is entered froa 
the system CCT or a station known ta the SMCS as a remote ODT» 
then the default vatue of the PROGRAMS paramerec may be changed 
durinc tater execution of SYCOM. . 
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Figure 4~3: Program-to*SYCOM schematic 


PROGRAM“TO“PROGRAM COMMUNICATIONS 


The program~to~program capability employs an entirely different 


eancecrt for inter-sycsctes coMaunicaticr. As orevicustly descusseads. 
this feature is an inherent byproduct of the system. SYCOM 


itself is tin ro way involved with the peprogramg-to"program message 
traffic end therefocres does not g¢rcevide any services to either 
programe The only exception to this is that SYCOM does “approve" 
a virtual terminal position for the pregram communications pathe 
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As shown in Figure 474 C(Cbelow)» communications are direct thru 
the Network Controllers via a special “remote file” dectared in 
each Controtlers explicitty for thet purpose. Both application 
progrécms ust have mirror isages of these remote files Cone each) 
dectared' as well. This remote file is shown in both Controtter 
exaaples (Section VI) as welt as both saaple application prograus 
CAppendix I). 


Figure 474 can be used to visuatize how an application program in 
one systems can communicate with a prcgram in another system. The 
input/output path is for the program to accept input messages 
from the Network Controller and return output reply messages’ for 
transsission to the other systea/prcgraa. It would behoove the 
develcper of these application programs to design a specific set 
of messages which exclude ary tersiral connotations. This could 
greatly siaplify development efforts extended for these prograags. 


The User Systen 


The Server Systen 
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Figure 4-4: Prograa-to-Frogram Schematic 


To convey certain recuired informaticans each input/output message 


must be prefixed with a “header”. The format of this Header is 
defined in Section 73 “Appendix Es Message Formats”. There are 
no restrictions as to the text in these messages but the length 


is controlled with the parameter “BUFFER*. This parameter is in 
the “SYCOM/PARAMETERS" file and is specified at initialization» 
or changed during execution by using the “BUFFER® command. . 


The usefulness of this feature must ke evaluated and decided upon 
by the system user. The capability is there to be utilized for 
whatever purpose. 
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NETWORK CONTROL 


The SYCOM User System is normally corsidered to be the remote RJE 
Staticn and must initiate the transaission of data to the Server 
SysteRe In a@ point=to~point non-switched network» this is 
accoertished automaticality by enablirag the Line adapter and then 
exchanging handshaking control messages with the Server System. 


In a point“toctpoint switched network» the User System must call 
the Server Systeme This is accomplished by either dial-out 
Cautomatic dialing by the computer) or by manual dialtun Cdialing 
performed by the system operator). The dialing is done “after” 
the adapter is enabled. When the Lire connection is established» 
the exchéengirg cf handshaking control messages with tne Server 
Systes® ts carried out. In a point*totpoint nonwswitched network 
utilizing a direct connections no dizling is dones or possible. 


Once this communication tink has been established with a Server 
Systems» Line communication is identical for the switched and 


nonswitched fmetworks. CThe User System ard the Server Systea 
Gust be compatible as to ransmissicn rate and other such 


ta a 
optioral hardware capabilities.) 


CONVERSATIGNAL COMMUNICATION PROCEDURE 


The following notes refer to the basic canversatiaonal line 
discipline eraployed by SYCOM. They acoly tc a pointto~point 
circuits either dedicatea or switchec?® 


Message Transfer: 

AtlL message blocks are delireated by special characters. 
Messages tegin with a “SOH™ character anc end with a "BCC" 
character. The message control format is as follows: SOH» 
ARM» TM#>» STX» DAL» ODA2» message text (blocked records)» 
ETX» and finally the BCC. 


Retranseission af Message: 

If the transmitting system does not receive a reply to its 
iast transmission within a given periscd of ties the 
unacknowledged sessage block is retransmitted. 


Parity or BSlock-Check Error Handting: 

If the receiving system receives a recognizable messager but 
it contains either a parity or ttlock-check errors it repliag 
with a *NAK™. The transmitting system should retransmit the 
wessage. This is repeated “n"™ nuwpber of times ("™n" being 
user specified)» ard if the errcr oersists» either system 
can initiate error recovery. 
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Message Idle State: 

If the receiving system receives a “good” @essagers but has 
no message traffic to send» it responds with an "ACK". If 
the sending system has more tsessage traffic» it sends 
another message blocke If the sending system has no sore 
message traffic» it proceeds tc the “message idle state”. 


Woraal Termination: ; ae 
The norawaal termination of a corversation occurs when one 
system sends an TACK" Cindicating that it has no more 
Sessage traffic)» and the syste@ receiving the “ACK™ also 
has no more message traffic. The systea pecetenns the *ACK* 
croceeds to the “message idle state”. 


POINT-TO-POINT CONTENTION PROCEDURE 


The essential characteristic of this procedure is that after the 
end-of-message transfer» as indicated by the transmission of the 


“DLE“EQT" sequences» toth systems are in an idle state. Either 
syste may then tid for master status by sending the *DLE“ENQ" 
sequences This is normatly initiated by the entry of a coamand 
to SYCOM. 


Master Status: 

If either systes is in the idle state and wishes to begin a 
- essage transfer» it may bid fcr master status by sending 

the “DLE-ENQ"™" sequence. If the sase system had just 

tersinated a message transfer by sending a “OLE-EOT” 

sequences then there is a detlédy created before this systea 

again sends the “DLETENQ* sequence. 


Begin Message Transfer State: 

If the system bidding for master status receives an "ACK" 
{indicating ready to receive)s it way commence message 
transfer immediately. If the response is “NAK”™ (not ready 
to receive)» the “DLETENQ” sequence say be repeated up to a 
retry limit of *n™ ("%n" being user specified)» and if no 
valid response is received» cossence error recovery. If the 
system bidding for saster status receives the “DOLE~ENO* 
sequence Cindicating that the cther system is bidding at the 
same time)» it abandons its own bid and replies in 
attordance with its readiness to receivee In order to avoid 
any tine collisions when both systems are bidding at the 
same times the no~response time out values aust be set to 
different values. This is true whether not the systems are 
Like” or “unlike™. 


Tersination: 
The “DLE-EOT" sequence is epaneeitked by the system directed 
to terminate to indicate the end cf its session» and if 


using a switched line» to disconrect the modem. 
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TRANSPISSION CF PACKED DATA 


As in previous versions of this pretccols data records within a 
message biock are -.separated By "RS" characters. Repeated 
occurrences of tlank characters are compressed out using the 
“ESC-integer”™ mecharisme The rethod of representing 
non-printable characters has changed with SYCOM's inaplementation. 
Printeble characters are those listec in “Anpendix 3» Character 
Set» with the exception of the “Line Feed" and “*BELL" 
characters. . 


If the data records contain only prirtable characters» then the 
first character of the record “is not" a "DLE" character. If the 
data recard contains any character ret in the "character set», 
then the first character of the record must be a "DLE" character» 


and the remainder of the record contains translated data. The 
original data is translated such that every 4-bits is mapped into 
an 8~tit printable character. CActual data transmissions occur 


in ASCII charéecter node.) 


NETWORK CONTROLLER 


The Network Controller provides interfaces with the User System's 
terminals and Server Systems at the hardware tevel. It is 
responsible att for direct comeunicaticn with those terainals and 
Server Systems. It performs the actual data transmission Cboath 
transmitting and receiving) functiors between two systems. The 
Network Contrcller accepts data messeqe blocks and system control 
messages from SYCOM end certain application programs Cprooram-to- 
program) and transmits them to the Server System. In reverses it 
receives ati messages from a Server System and forwards them as 
required for handling control and distribution. The SYCOM 
program reties upon the MCP for the basic function of “message 
queuirg™ between it and the Netwerk Controller and certain 
application programs. This facility provides the message paths 
between SYCQM» the SMCS» apolication prograss» and the Network 
Contrclitler. 


Following is a normal sequence of events which transpires between 
SYCOM» the Network Cortrollers and the system's terminals: 


In response to a “pott"™ by the Network Controtler>, a terminal 
trans@®its a message back to the Netuwcrk Contrcller. The Network 
Contrcller accepts the message and appends a header» supplying 


pertinent information about the messages (Ceeger» terminal type» 
Lane etce). The Network Controller then determines which prograg 
to send this message to and writes it into the appropriate 
program"s remote file Cinput queue). CAssume in this case it is 
SYCOmM.) SYCOWM reads its remote file Cinput queue) and obtains an 
input message. Should the message be a SYCOM commands it is 
processed and a reply message createc.e The reply message is then 
started down the tine by SYCOM when it writes the output message 
inte its remcte file to the Network Controller. Tne Controller 
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in turn reads the reply message anc transmits it Cdevoid of 
header of course) to the originating terminal. 


The description on the relationships of the SMCS and the Network 
Contrcller with SYCOM» which is alsc considered an apptication 
progr2z@s» apply to any application prcgram. Thus» any application 
program can enjoy the benefits of a sophisticated terninal 
network with message/terainal/progras management thru the SMCS 
and Network Controtter. In summations the SMCS is the message 
contrceller for the systenr. It also provides a ayriad of 
functions which direct Network Controller functions ._as welt as 
special purpose MCP functions. 


CONFIGURATIONS AND SOFTWARE ASSOCIATIONS 


The Systems Communications Module has been designed to operate in 
either of three sodes: 


Level 1) as an individual entity "“without™ Local terminals 
Level 2) as an individual entity “with™ local terminats 
Level 3) in conjunction with the SMCS> also with terminals 


Referring to Figures 475» 4°6 and 4°77 Cwhich follow)» the system 


configurations with supporting software elements are shown and 
described. 


LEVEL 1 SYSTEM 


This systes configuration provides alt of the SYCOM capabilities 
previcusly defined which includes the ODT as a virtual terminat. 
This is accomplished with the seatllest memory size commitment. 
Although the comsmanc repertoire is generally confined to entry 
from the system ODT» special application prograss running in the 
systew can alternately inject commancs to SYCOM for processing. 


In the User System schematic which follows CFigure 4-5)s the 
communication links between systea scftware elements are showne 
Each of these links» “queues" and “remote files"» have specific 
purposes which are briefly identified as follows: 


A. "INC" is a queue file ysed by SYCOM ds Qutput to an 
application prdgram utilizing the “Progr as-to-SYCOM” 
facilities. . 


E. "“OUTC™ is also a queue fite used by SYCOM as input from 
. an application progras utilizing the "Prograa~to-SYC OM" 
facilities. 


C. *LINK” is a remote file which is used in comrgunications 
with a remote Server “hest™ Systese All RJE and 
virtual terminal input/output sessage traffic moves 
thru this file. This rescte file is directly retated 
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to the SYCOM communicatiors Line to a remote host. 


C. "RFUSER™ ais a user defined name for a remote file used 
for program-to~program I/0 sessage traffic» priwsarity 
directly thru the Network Controllers. Alt messages 
for this remcte file move thru the same communications 
Line as those identified fer the "LINK®™ file. - 
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Figure 4°53 User System Schematic. 
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LEVEL 2 SYSTEM 


This system configuration also provides all SYCOM services as 
outlired for the Level 1 System ard extends this to inctude alt 
local terminals.- With tersinats» SYCOM functions can be invoked 
from outside the computer room and away from the system ODT. 
Termirals on the systes increase sesory usage in proportion to 
the nusaber of terminals attached to the syster and the tine or 
Lines for tersinalse The memory increase howevers will be in the 
Network Controller program and not SYCOM itself. 


Locat terwinals are exclusively ownec and controlled by SYCOM. 
Although there is no operationad S¥CS required in a User Systens 
it is "required" in a B1800 series Server System when Reaote ODT 
type activities are needed. The introduction of terminals in 
this system requires another remote file declared in both SYCOM 
and the local Network Contreller: 


he "TERMINALS" is the remote file used by SYCOM for local 
terminal input/output message traffic between it and 
the Network Controtler. 4s the cantrotler handles atl 
necessary terminal interfacing» SYCOM only reads input 
from and writes output to this remate file. . . 
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Figure 476: User Syste Schematic Cterminals) 
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LEVEL 3 SYSTEM 


Using this configurations not anty are all of the capabilities 
provided as outtined for both the Levelt 1 and Level 2 systemss it 
now provides the SYCOM terminal user with an access to all of the 
capabilities afforded by the Supervisory Message Control Systea 
CSmCS). Mewory increases in this configuration are directly 
related to the SMCS and the Network Controller. 


Local terminals in this system configuration are under direct 
control of the SMCS. Upon command (SMCS “sign on")» a terminal 
is temporarily “attached™ to SYCOM fcr functional communications. 
when this SYCO™ attachment is no loncer needed» the terminal is 
“detached™ from SYCQM by entering “<secs signal character> OFF or 
oBYE"S This command is passed on tc the SMCS by the Network 
Controtler which initiates the actual detachment and again 
assumes control of the terminal. As such» an additional terainal 
I/O tink is needed- Also» in addition to this link»  SYCOM*s 
remote file “TERMINALS” is effected somewhat. Both are described 
as follows: 


A. “MCSREMOTE" is a reaote file used by the SMCS as a Link 
to the system"s terminals. Atl terminal 3/0 message 
traffic between SMCS and the Network Controller passes 
thru this” file. Durirne the time a terminal is 
*"signed-on™ to SYCOM» certain messages are “switched” 
to the SMCS for processing (Cthose wsessages prefixed 
with. a SMCS “signal character"). 


Ee "TERMINALS™ is SYCOM's reacte file for teraminal input/ 
output message traffic between it and the Controller. 
The slight difference being that terminal input/output 
only passes thru this file for those terminals that are 
"sigqned-on* to SYCOM. 
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Figure 4°77: User System Schewétic CSMCSs terminals) 
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MESSAGE PATH ASSIGNMENTS 


In order to describe the potential sessage communication paths 
opened up by the virtual terminal capability» a special sessage 
path syntax was developed to pictorially present this ayriad of 
possititities. The message path syrtax is easy to understand as 
one can visualize these logical paths thru the User and Server 
Systegs. System software elements are easily recognized by the 
widely used acronyas Cait defined tn the “Glossary"). Although 
the directional flow arrows “-">" indicate a single direction» 
communications are twocway. The boxed in syntactical etements to 
the right indicate an alternate message paths also avaitable 
thru the “virtual terminal" capability. 


FOR THE LEVEL 1 SYSTEM 


COT input: : 

For this systews level (Figure 3-9) there are three message 
paths for ODT inpute The following exaaples exptore each of 
these possibilities: 


User Systes { Server System 


Beas ecq se ae aaee®» SSO Raeaeese Beans @ @& seaaweqnqeanagea facean se Eaenme Sewen ae w= 


I ! 
GODT <--> MCP ==> SYCON s=""-> NC s--e= 4 
i / i 
1 worse NC omen-> SYCOM I 
| | i 
o<XXX> o7="=> SYCOM i 
CXXX> fete eee een nw en wn ese receceen= “-> SYCOM ---> ODT 


As shecwn in this diagram» alt input command strings are given to 
User SYCOM by the MCP. Messages prefixed with a period *.* are 
processed by User SYCOM. CThis pseudomsignal character "." can 
be changed by using the “SIGNAL” coggand in SYCOM. It reverts 
back to the default 7.» or whatever was specified by the 
DEFAULTPSEUDOSIGNAL parameter» when the SYCOM user signs-off-) 
All ecther input messages are sent to the Server System's SYCOM 
which will display them or that ODT. 
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then the "virtual terminal™ capability is invoked (by using the 
".SCONNECT™ command)+ the following fessage paths are estabiished: 


User System ! Server Systen. 


ee ee ee ee ere eo SB eee eS 


eCCANNECT <--> SYCOM f 
{ 
! i 
ODT <--> wCP <--> SYCOM cm="> NC cere 1 
1 / 1 
Pt <see8 NC “"-7> SMCS 1 
! 
2<XXX>  t+9-> SYCOM ! 
CXXX> tee e eee ce ew ee cece neee= meme sewn momen ewen—=> SMCS 
2<XX> 0 twee wes eeeresee- ereecrre \em-==> SMCS “<--> MCP 
ZENS. “OSPR SPS SSS eS See eee > SMCS =--> MCP 


The SYCOM pseudo~signat character sxust immediately follow the AX 
without intervening blanks. Any rupgber of blanks Cinctluding 
zero) may» howevers, follow the SYCOM pseudo~msignal character. 
Wher a SMCS is running in the Server System» the ODT operator can 
either “signton"™ to a proqram in that system or initiate RSC tyne 
commends» thru the SMCS. When the virtual terminal is signed~on 
to the specified application orcgqrag» it is "*attached™ to that 
progréeme Ail further nonwprefixed input is sent to that program 
for frocessirce CIn the exarcple below» the "8S" character is 
assumed to be the Server System's SMCS “signal character"; it 
can te another character.) . 
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User Systee ¢ Server Systea 

28S 88 OS OS OOOH ABBE BABA OSTA TO BOBO MD eB STF HBTs Lee F Oneness ewee sce eee ene 
j 

SIGN ON AP «77> SYCOM { 
' 

1 | i 

i / | 

t seser NC. -eF=>:; AP I 

i . \n> SMCS i 
t 
o<XXX> eee > SYCOM | { 


<XXX> Ba aaa aces aad marae” dae | 

£<XXX> eer ee ena coer eee eset ees wee esas seecaeesoeee=~)> SHCS 

$25KNS. “SseeteerersesssseesSesssess—sS>. SNCS ===> NCP 

26nd Here ee er terse ese ces see ere Ser "> SNCS. 25> OCP 
j 


Progr aa~to-SYCcon input: | 
For “Program~to~SYCOM”™ communications» the following message 
path assignments are available: 


User System ! Server Systes 


AP 0 stetersece==> SYCOM tae> NC erenn 4 
; / ; 
ws-2- NC m---> SYCOM I 

I 

e<XXX> ose--> = SYCOM 


<XXX> se-=> 6©6SYCOM 


ALL irput command strings are given to User SYCOM by the MCP via 
the “QUTQ™ queue. Messages that are prefixed with a period "."” 
are processed by User SYCOM. 


When the “virtual terminal™ capability is invoked Cby entry of a 
".CONAECT"™ command)» the following wsessage paths are established: 
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User System eee te 


eCONNECT <-->. SYCOM 
| a a I 
AP ow eneree ween=> SYCOM me => NC seem i 
. , ) 1 fgets test tebe / a 8 i 
ae swewee NC see-> SMCS | 
| ; , a ft, 
o<XKX> ose > SYCOM 1 | 
<XXX>:  -Seesteees ese Ssnsee Sennen aneenernane waa e=> SMCS 
2eXX>.. “SeeSeean=s--5> asa e aR sea “==> SMCS --"-> MCP 


ZS000>> CP Sen cess essers see eee eee “SMCS 0 ws—> MCP. 


Wher 2 SHCS is running in the Server System» this program can 
"sign-on™ to a program in that systes or initiate RSC commands, 
thru the SMCS. - When this virtual. téreinal Cprogram) signs-on to 
a specific application programs it becomes "attached". Atl 
nonprefixed irput is sent to that Server program for processing. 
CIn the exaaple below» the *$" is assumed as the Server System's 
SMCS “signal character"? it could te somethirg else.) 


User Systes 1 Server Systea 


ae ne ee ee ee he Pl he aman ew anne ene sem Poa waeananww meses ewe mee — oo 
. 1 
SIGN ON AP wr3r"> SYCOM . | 
| 
! m5 | 
AP 2S a am a moe > -SYCOM’ ==9=> NC: s=<2= ! 
i / 4 
j oO cance NC se2=> AP ! 
| \V-> SMCS. 1 


eS¥XX> s=er-> SYCOM | 
<XXX> a as oe ee oe ee ws VCIsFC SG SMF OSes TSK ENON sane wee» AP 
$<XKX> sa saan nen w ae SS ee ee ae ee eee ee SMCS. 


gree ESA R 2 be eho he eicios leap iri aa < “SMCS ee “‘*CP 
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Progras~to-progras input: 

The message path for progras-to-program communications is 
timited to the following predetermined path. Messages can 
be any foreat and contain any text agreed upon by both 
epplicaticn proagraase The onty prevailing restrictions are 
wsaximum “buffersize” and ail messages Must be prefixed with 
a “header™ C*Appendix E”). 


User System I! Server System 


i 

AP ween enn een n ee eneeecenn=> NC one-- 
of 
1 


FOR TEE LEVEL 2 SYSTEM 


In this conficuration (Figure 3-6)» the ODT and alt terainals 
attached to» and awned by» SYCOM norsally cosmunicate with local 
SYCOM. When the virtual terminal capability is utilized» these 
devices are persitted to communicate with either the systea 
software prograas or appropriate application prograas in a Server 
Systege 


The OCT» program=to-SYCOM» and program-to-program input message 
paths for this software configuration are the same as_ those 
defined for the “Level 1 Systee™. The following message path 
assignments are for local terminals attached to this system: 


User System !§ Server Systen 


ae watT Bae eT Swe TZ eT eO C HOB TB AFA BBTeAeTneaeesn wees LF aaeateone = ep an @ w= 


VOT <--> NC “=> SYCOM 


1 

1 
| 1 
@<XXX>  --==> SYCOM ! 
i 


By entry of the “CONNECT” command tc SYCOM the virtual terminal 
capability is invoked. The following message paths are then 
established for the terminals 
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| 
eCONNECT w---> # SYCOM . | 
! 
| | 
VOT => NC ==> SYCOM- -©-<<=-> NC eee ! 
I / 1 
1 otter NC sm-"> SMCS) oI 
, 1 
o<XXX> “e-=> SYCOM i 
CXXX> tetera cescnae oer em cance eam en eenneseeren=> SMCS 
LO.1S*" Gaeeeacssssaeeseees Seecseassss>: SNCS = =2>. HCP 
2KONn? “Sarees ese oresssesesaeneeee=+==5' SHCS = <=> iMCP 


1 


wher 2 SMCS is Cunning in the Seryer System» the terminal user 
can either “signon* to a program in that system or initiate RSC 
type commandss thru the SMCS. When a virtual terminal signs™on 
to’ a specified application oregram#» it is “attached” to that 
programe. ALL further nonwprefixed input is sent to that progranm 
for frocessirg. €CIn the exaacie beflows, the "8" character is 
assumed to be the Server System’s SMCS “signal character"™> it 
could be another character.) . 


User System 1! Server System 


VOT “<> NC -<-> SYCOM aa«22>5 NC ye 


y st--- NC som-> AP 
I \-> SMCS 
! 
e<XXX> se-=-> SYCOM 1 
<XXK> See set et ee tet eee ees ese a seesaw ea sw aseere=s=e=) AP 
$<XXX> Ee rere nt ee ee et su aaa Ban eseananewseoaanecenwe=> SMCS 
SZCKK> “FeSee Sener aace= eeeenneneen--> SNCS) <--> MCP 


$Z<nnn> ceo = ween enw enn eee esemenn=> SMCS <---> MCP 
1 
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FOR THE LEVEL 3 SYSTEM 


In this configuration (CFigure 3-7)» all tocal terminals are 
attached to» and owned by the SMCS. Therefore>s the noraal 
message communication path is to the User System's SHCS. When 
the virtual terminal capability is utilized» these terminals. are 
permitted to communicate with either system software programs or 
appropriate application prograas in the Server System. 
Additionallys these same terminals are peraitted to communicate 
with any aopropriate application program in the User Systen. 


The ODOT» Program-to~SYCOM» and Procgrarg~to~Program input message 
paths for this software configurétion are the same as those 
defined for the “Level 1 Systea". The foltcwing message path 
assignments are for att tocal terminals attached to the User 
Syster*s SMCS. First the normal sessage paths for terminal aneet 
within the User Systeas are presented: 


User Systew 1! Server Systea 


i 
‘WOT <--> NC “=> SMCS 


<XXX> 2c2-=> 86SMCS 
2<XX> e=--> SMCS ==> WMCP 
Z2<nnn> e7277°> SMCS ==> SCP 


In order for the terminal user to gain access to a SYCOM system» 
one of two access methods sust be used: 1) By using the betow 
SMCS "SIGN ON* command procedures» or 2) By utilizing the sethod 
wherety each ccoamand is “*PASS"d*™ to SYCOM via the SMCSs it is up 
to the user. CAlthough this exasple is for a sign-on to SYCOM> 


it cculd be any appropriate applicztion programs in the User 
Systean-) 


1 
SIGN ON SYCOM <-<-"""=-> SMCS 1 


The following wessage path assignments are then in effect for all 
tersinal input. 
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| 
| i ee | 
YVOT ==> NC 72> SYCOM -27°7> NC ere ry 
\-> SMCS | / ] 
| wene= NC “--=--> SYCOM 1 
; ! 
0<X¥XX> ce-2"—=> £SYCOM | 


<XXX> os see=> «6 SYCOM 
#<XXX> ceeren> SMCS 
#Z<XX> teen > SMCS  —-=> KCP 
aZ<nnn> ““"7—-> SMCS ==> MCP 


The “virtual terminal™ capability is invoked when the terminal 
user enters the “CONNECT? command tec SYCOM. Following are the 
message paths now established for the terminals jf a SMCS is not 
Gurrertly cunning in the Secver Systes: 


ee — Ss Sat 


VDT ==> NC cna = > sSYCOM aawnae)y> nc anew oe 


\-> SMCS i / 
i ----- NC 1 

i 

o<XXX> os--=>  SYCOM 


<XXX> “s--> SYCOM 

B®<CXXX> eer=> SMCS | 

aZEXX> =e-—> SMCS --> MCP j 

*Z<nnn> e777> 8 86SMCS “-> MCP 1 
] 


When there is 2 SMCS currently cunnicrg in the Server Systems then 
the fotiowing message paths are estabtished for a terminal: 
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i 
3 ! i 
VOT <-> NC s*"=> SYCOM <""%> NC -o=== 1 
\-> SMCS t / i 
I wte-- NC ----> SMCS 1 
4 
e<XXX> o-e>=> = SYCOM i 
CXXXD tems ewes eer cess cecnccersen=> SHES 
ZKXX> 0 see nee erence ene-=- mecaecss----> SMCS <--> MCP 
Zénnn> =<" 9-9-""-"---- meesesscsrcene-=> SHCS <=> MCP 
A<XXX> os ee=> SMCS i 
8Z<€XX>  see-> SHYCS ==> MCP 1 
#Z<nnn> <---> SMCS ==> MCP 
| t 


With the SMCS running in the Server System» a terminal user can 
either "sign ton" to a program in that system or initiate RSC type 
commands, thru the SMCS. When a virtual terainal is signed-on 
to 3s specified application progqréers it is “attached” to that 
program until the tereinal user “signs-of f*. ALL non-prefixed 
input is sent to that application program for processing. CIn 
the examples below» the “*#" character is assumed to be the User 
Systes"s SMCS “signal character*® and the “$* character is assumed 
to te the Server System's SMCS "signal characters they can be 
different.) 


User Systes 1! Server Systen 


Ce ee ee oe Oe ee 2 OU San ee Team 2 en anteoewes BZ ee eee feet ee sem eBeeFe2 eZee 22228 


SIGN ON AP seeeeseerneseneeecesessreer= ere > SMCS 
i 
, ' } 
VOT <-> NC se—=> SYCOM se-9> NC seer ! 
\7> SCS t | / { 
I SSeee: NC = S3>: AP ! 
‘ \-> smcsS 1 
| ' 
e€XXX> <---> SYCOM ' 
#<XXX> sewn => SMCS . { 
BZEKX> women > SPCS <--> MCP t 
eZ<ennn> ce---> SMCS => MCP t 
SEUKS: Serer eR estes were esa Sere ees seen ce eeene- > AP 
I<XXX> ee ee eee 2S SS eee eS Sere Sea a> SMCS 
IZEKK> SH SSe reassess e= aesSosse=5> =-> SMCS <--> MCP 


SZ<NNhe SS SorT eS seer ess = eee e neem ees—-"> SMCS ==> = = 6MCP 
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QUEUE DEPTH CONTROL 


In the SYCOM operational environment» there is a MCP controlled 
data path which exists between SYCOM and the Network Controller. 
This data péth is referreca to as the “remote file™ Cor message 


queue) mechanism. Due to differences in data communication line 
transesission rates and peripheral irput speeds» this remote file 
becomes a buffer. Without some kind of control on the message. 


traffic thru this file» it could crow teyond reasonable Limits or 
be jammea full. ; . 


To previde a control cver the number cf message blocks that can 
be cueued up in this file at any given time» a “marker message" 
systems is employed. As SYCOM is putting message blocks into this 
files a count is maintained. Wher this count reaches the halfway 
point of the aqueue deoth Limit» a warker message is put into the 
file. The marker message is a specially prepared data message 
with ¢ code in the message header. This special code ensures 


reccgnition by SYCOM when this messace is echoed back to from the 
Network Contrcller. 


Once a marker message is piaced into the file» SYCOM continues 
putting message blecks irto the file until the predetersined 
queue depth Limit is reached» at which time peripheral input 
operations are suspendede When the Network Cantroiler encounters 
the mzrker message during the trarsmission of the queued message 
blocks» it acknowledges receipt cf a marker gSessage by returning 
a "“flzeg™ in the corresponding "ACK" gessage ta SYCOM. When SYCOM 
receives this acknowledgement» it resures peripheral input» again 
places a marker message into the file and continues putting 
message tlocks into the file until the queue Limit is reached or 
until an endtof-file conditions whichever occurs first. 


The current values of the “oueue"size"™»s and tt associated 
marker-of fset» way be queried cr changed with the “QS” command 
during executions or with the “CUEUESIZE" parameter during 
startup. 


SYSTEM FILES 


In the total system pictures» there are many files and file types. 
Howeverr as this systes overview pertains only to SYCOM and its 
relationships» onty those pertinent files which are required for 
SYCO* operations are presented. Following are file descriptionss 
by software element» that are necessary for SYCOM operations: 
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MASTER CONTROL PROGRAM CMCP) FILES 


CSYSTEM)/USERCODE File 


‘This file contains alt valid usercode-passwords that are known to 
the systes. It is used by the MCP to enforce file security disk 


files and procrams/users that access them. With this file» the 
MCP can service any requests by programs regarding validity of 
specific usercode"password combinations. CThis file is only. 


required when the system is operating with “usercodes”.) 
NETWORK CONTRCLLER FILES 


Network Information CNIF) File. 


This file contains tables that descrite the physical and logical 
attributes of the network. The initialization vatues for lines» 
termiratss» and file tables of Network Controller are contained in 
this file. This file is created by the NDL coapiler when it is 
in the process of generating a Network Controller. 


SYCOM FILES 


The Systears Communications Module utilizes many types of files in 
the aanagerment of its domain. There ares peripheral Cincludes 
disk)» remote communications» and queue files. These files are 
briefly described here» under separate headings» with detail 
descriptions for major files available in the appendices. 


Peripheral Files 


These files are generalty used to ingut/output RJE type data and 
include the card readers» card punch» tine printers magnetic taper 
and disk files. Also there is a disk file which is used by SYCOM 
to manage the various options ard settirgs. Following are 
general descriptions of the SYCOM files which fall into this 
categcry: 


A PARAMETERS File 


The PARAMETERS file is a single record file containing 
required operational parameters for SYCOM. It ts static 
and can onty be changed by resgoval and recreation. This 
fite is created by SYCOM upon the entry of appropriate 
parawseters from either disk» card readers or User ODT. 


B.- NEWPARANS File 


4-37 


BURRCLGHS CORPCRATION COMPANY CONFIDENTIAL 
COMPLTER SYSTEMS CROUP £18900/81700 SYCOM 
SANTA BARBARA PLANT Pe Se 2219. 0458 CA) 


The “SYCOM/NEWPARAMS™ file» on disk or cards» can be 
used to create the "SYCOM/PARAMETERS"™ file in vreference 
to entering the “paraseters*™ wanuatiy from the ODT. 
This file can be created using CANDE or any = other 
supported text/editor pregrem and is free=formats 
explanatory comments may cr may not be inctuded in the 
file. 


Card Inout File 


This file is used to input KRJE card data files from the 
system's card reader. It can be either a 80~-column or 
967column device cr a diskfilewj However» in the case of 
the 9€-columr card readers» cra diskfite onty the first 
$0 columns are processed. 


Card Cutout Fale 


This file ts used to punch RJE card cutput aata files to 
the system's card punch. It can be either a 80-column 
or 96~"colurn afvices as apecrcpriate. 


Printer File Coptional) 


This file is used to print atl RJE print files that are 
beinas».or have beens received from a Server Systeme The 
tine crirter device can Ly ery one cf the various models 
that can be attachea to the systems which can be either 
a 1i20-enpositton or 132700sitton line printer. If no 
printer is available» the printer-backup files may be 
transmitted to a “remote system” which has a printer. 


There is an additional prirt file which is used to list 
SYCOM*'s "TRACE" or "“OLDTRACE™ files via the “.LIST"™ 
commends it does not irterfere with printing the KJE 
type print files received ty SYCOM. 


kKemote Files 


The remote fites are usec iff tonmMmUuNications between SYCOM and the 
Network Controtler and SYCOM and either the terminals or S3MCS. 
There ere two cf these files whicr are described as fotlows: 


Ae 


The "LINK" file ais usec fer all input/output messages 
relating to RJE anc file transfers? specifically» 
station tyoes for Centrcls» QCT CSPO)» Cards» Printer» 
and File records. 
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The “TERMINALS” file is the communication Link 


between 


SYCOW and the Network Centroller for tocat terainat 
wessages. This remote file is however» only used when 
there are tocal terminals; controiled by either the 


SMCS or SYCQOM. 


Queue Files 


The cueue files are utilized by SYCOM for buf fered communications 
between itself» the MCP» and the Netsnork Controtler.j The purpose 


of each of these queue’s is describec as follawss 


Ae RJE Queue 


Used to save printer/punch data received from the 


other 


system when the User System's printer or punch is busy. 


E. LINK Queue 


1. Used to save input rwessages fros the other systen 


during the “*initialization™ phases else they 


be tost.e 


may 


2. Used to save output sessages for the other systea 


when “messages queued” exceeds “MAX~MESSAGES". 


C- INQ Queue 


This queue is the mechanisa by which SYCOM = sends 


ceply 


messages to an applicaticn program dealing in prograa- 
to~SYCOM coamunications. SYCOM “writes” into it and the 
application prograws “reads” from it to obtain messagese 


Ce QUIG Sueue 


This queue is the mechaniss whereby SYCOM receives input 


cowmand messages from an aprlication program that 


deals 


in program-to-SYCOM cossurications. The application 


program “writes* into it anc SYCOM *reads” from 
obtain tnput messages. 


RESTRICTIONS 


to 


The following restrictions are valid for the system based on a 


Logical evaluétion of the systea's requirements: 


- Maximum wessage block size 


1950 bytes 


» Minimu@ message block size 


162 bytes 
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- Maximum simultaneous system ccrnmections = 1 

e Maximur messege block aqueue depth = 255 

- Maximum number of file transfers queued to process = 99 

- Maximum number of terminals supported = 15 

- Maximum number of card reacers supported = 1 

- Maximum number of card punches supported = 1] 

- Maximur number of tine printers supported = 1 


- Neither LCAD-DUMP or SYSTEM/CCOPY tapes are supported for 
file trensfer operations. 


- Only “data type files*” are file transferable tetween 
disk/tape and tape/aisk Ccaodes files are invalid). COnly 
one data file per tape 1s allcwed.) 


» Get tyce files» teee» tyfe > 15» are not supported = for 
file transfers. 


- Multi~point networks are not supported by SYCOMs at this 
times 
» Message blocking is orohibitec. CA message block already 


contairs multiple records cr cata images) 


- ‘Monitoring and controlling of programs in the Server System 
requires a MCS executing in that systere 


« This system does not support “binary synchronous” 
communicationse 


These restrictions may be changed during subsequent development 
cycles» tut are however» currently ir effect. 
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‘OPERATOR COMMANDS 


GENERAL 


The set of commands described in the section is used to direct 
the System Communications Mcdule CSYCQM) program operations from 
either the Crerator Disotay Termiral CODTI)» a remote operator 
displey terminal (remote ODT)» ¢ system terminal» or an 
application program runnirg in the system. 


Non=SYCOM program commands are also permitted to direct 


user=system ard server-system operations by way of respective 
oMCS%s. 


A rencte fQ0T station is a staticr that is known to SMCS as a 
remote ODT station anc is detined in the netwerk controller with 
a. transmit frecuency greater than 24S. 

A workstation is a station that is krow “CS a5 &@ workstatio 
er controller station and is defined in the network controltter 
with @ transmit freauency less than cr equal to 249. 


in tan S¥CS 


Table 4-1 at the end of this section contains a summary of all 
the SYCOM commands available in the SYCOM program. 


INPUT COMMANDS 


Each statement in the Command Language consists of a command ands 
im scene casess a List of parameters. The parameters in the List 
are separated from the command and each other by blanks. In the 
following exanroles single sraces are used although the use of 
muttiple spaces between command elemerts could be used. 


when the SYCOM has finished processirg a commands it displays a 
reply message either confirmirgq successful completion of the 
command or indicating an error. Errors terminate the processing 
of a comand, the entirs command wust be rewentered correctty 
Cexcert for commands which alton multiple operands such as 
»LIST). 
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COMMAND SYNTAX CONVENTIONS 


The rotation conventions that are described below are used 
throughout this section to describe the syntax of each command. 


Notation used in modet format 


Firsts» a model of a command is noreserted- This gives the user an 
overview of the enennee of the cogsand structure. 


eCOPY <file-nase-1> CCUSER=<userccde>)) [-----> AS -------> 
I--> ONTO -->! 


e-=> <filername-2>] FROM CHOST=<id>) TO CHOST=<id>) ---->Z 


BRACKETS: | . 
Information that is enclosed sithin brackets C€] represents 
an option which say be used or ormitted by the user. In the 
sodel exasple given above» the cptions USER» AS or ONTOs and 
"file-namse-2" indicate three possible choices when using 
these options» or the choice of not using any option. 


BROKEN BRACKETS: 

Left and right broken <> brackets are used to indicate that 
the enclosed variable within the brackets sust be replaced 
ty digits and/or Letters whose Nemes is determined by the 
context of the comwand. 


UPPER CASE LETTERS: 

Words that appear in upper case Getcers indicate that the 
word is ae Lliterat and must be substituted verbatia»s when 
used. In the aodel given aboves the word -COPY woutd be 
entered first when constructing a command statement. 


LOWER CASE LETTERS: | | 

hords that appear in tower case tetters indicate that a 
value must be supplied. In the model aboves the word 
“file-nage"1" indicates that a character string representing 
the name of the file to be copted must be entered. COMMAND 
STRING SYNTAX CONTINUATION: A few of the coaumands have a 
considerable number of syntactical itess. which overflow a 
printed line into two or more coanand string lines in the | 
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presentation. To provide a clear tine cf continuation for 
the command string» the use of Line direction arrows are 
used. A Lire direction arrow eppears as -""""> and atways 


flows feft to rignts to cantirre the command string. It is 
easy to foltiow 2@ command string in this format as it is 
logical in nature. 


CPEN“CLOSE PARENTHESES ()=s 

kKhen these characters appear in a command syntax statement 
they are required input. see the "COPY™ command for a use 
reference. 


SLASH /s 

khen this character appears in &€ command syntax statement it 
is required inpute A Space or spaces on either side of this 
character are not allowed. - | 


END OF STATEMENT: ; 
The end of a command statement is titndicated by the 
appearance cf a % Cpercenrnt sigr). It is a syntactical 
string terninator but is only reoauired if commentary cext is 
included in the command innut.e 


Punctuation Rules 


The space» the comma» and the pericd are corsidered punctuation 
marks Cexcept in literats) end are usec as follows: 


le The space Cblank) 1s a serérator» recsuired after words 
and literatis in the absence of any cther separator. A 
space may precede or fottow any other separators» and 
many speces are the same as cne Cexceot in literals). 


va A comma is a separator that is tegat only where it is 
snecifically indicated ir the cammand syntax. The 
comMda»s where it 1s legals» . can aiso serve as a 
terminator for words and rumeric literals. The comma 
is never required» except tc separate criteria in a 
command string. 


2. The period is a reouired prefix to tocai SYCOA 
— comBandse It is never recuired within any command 
string syntax. Its only acceptability would be as an 


embecded character ina file mame» system identifiere 
or usercode/password.e 


Commerts 
i. SYCCM commands and/or operands may be entered tn either 
uoper or tcwer casee File -rames» howevere must appear 
exactly as recorded in the system disk directory. No 


trarslation will occur. Currently any quete marks that 
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are encountered in the comsand string wilt be taken 


only to mean a quote mark» not t9 start a guyoted 
airing. | 


Ze Passwords containing either the special character °%s"- 
or "2" will not be reccqnized. 


COMMAND RELATED ERROR MESSAGES 


Error messages specific to the follaning SYCOM commands appear in 
Appendix A (Comeand Error Messages). 
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ABORT 


The AEGRT command causes the SYCQOM ecrcgram to abort an in-process 
tile transfer or a scheduled file trersfer. 


Syntax: 
eABCRT*--<=-= CONNECT sere sn strewn een w neem n cern mower nen nnenannecnecas > 
im-- FETCH --3 I-- <schedule numrber> --! 
l-- PUT coor! Jor Sse e es ecwennnennn- ! 
> nanan an ese ewe ST EE Ee eS STS SFT Ws weaaesss es 22 eOweswt BF ar see nasFan tw e@aeBweuwwe © 2 @ we oo we 


I-~ Z <ccaments> =~] 
Semantics: 


CONNECT Causes a schedutec connect to be removed from 
the schedule. Connects will only be 
scheauled when the remote system is off line. 


FETCH Causes the inwprecess file transfer initiated 
by the FETCH cowmsard to be aborted. The file 
being received is not saved. 


PUT Causes the inveprccess file transfer initiatea 
by the PUT command to be aborted. 


schedule number Identifies the file in the file transter 
schedule to be atorted. If the field is teft 
blank» the FETCH cr PUT cperation in process 
is aborted Cif ary). 


= | Aborts the in-¢roecess file transfer and all 
files scheauled to be transferred. The equal 
sign (C=) character must follow PUT or FETCH. 
ABORT FETCH = cr ABORT PUT = jis only vatid 
trom the system CCT. 
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Exagpless 


eABCRI FETCH  $=(% Aborts the file transfer in process which was 
Z initiated by a FETCH command. 


~ABCRT PUT % Aborts the file transfer in process which was 
ZX initiated by a PUT command. 


Z Aborts the file transfers schedule number 4& 
Z in the PUTQUEUE of the remote eyayene whether 
% in process ofr not. 


eABORT FETCH & 


eABCRT PUT 10 % Aborts the file transfer» schedule number 10 
%Z in the PUTQUEUE cf the local system» whether 

Z% in process or note 

eABGRT FETCH = % Aborts alt file transfers in the PUTQUEUE of. 

% the remote syster and the in process file 

2 transfer Cif any) which was initiated by a 

% FETCH commande — 

eABCRT PUT = Z Aborts att file transfers in the PUTQUEUE of 

“5 Z% the local system and the in process file 

% transfer Cif any) which was initiated by a 

Z PUT command. 


The SYCOM wsessage PUT REQUESTOR MISMATCH can occur if the user 
attewpts to abort a PUT or FETCH operation of a file andthe 
source file was secured with a usercode/password. 


Any one of the fottlowing conditions wuUsSt exist to initiate a file 
transfer of a secured file. 


Le The user must be tlogged or to the SMCS With 6a 
usercode/password and enter the PUT or FETCH command to the 
SYCOM program through the PASS ccamand to the SMCS. 


Exaapless 


PASS SYCOM PUT <filename> 
PASS SYCO™M FETCH <filenane> 


Ze The user aust be Logged“on to the SYCOM program by entering 
the US command to the progras. 


Example: 
US = USER/JONES 
36 The user must assign a usercode/password to the source file 


when a CCPY» PUT» or FETCH SYCOH com@and is entered to the 
SYCOM procrasr. 
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Exateles: 


-PUT MASTER CUS = DOE/JCHN) ~ 
“FETCH FILEA CUS = USER/PAUL) | 
-COPY SQURCE CUS = ODT) FROM CHOST = 81800) 
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ADD 


The ADD command causes the SYCOM program to initiate a file 
transfer. The command syntax provices for the transfer of files 


from the initiating system to another system and from another 


system to the initiating systea. Ite files can be in either 
magnetic tape or disk fora. The file transfer will be aborted if 
the destination file exists at the receiving system. 


Syntax: 


I-- ( ceeenm-/ 1 /-- <usercode part> -"- 2) --1 


| ae 
maf 1 foereeermerm= LIST 71 


t I-- NO ==! 1 
; | 1 
b--/ 1 /non--- REMOVE -----1 
b--/ 1 fetmen= SAVE weennl 
I--/ 1 /o-e--- SKIP <n> ---1 
In-/ 1 forces FILE -------! 


1- BINARY ~-f JI- AS w“-~ <filenaser2> -!1 im (C<usercode part>) J 


j°-= FRO OOS SOR SSSR SPE TSS TST SOT TTT SO SOOO BE TF OT BEG ens eae a A 


I--- <volume1> ---1 I--=- B 
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= 2 Sess e5 Sea S44 = S=7 p22 RSS SS SS SS ae ace { 
! 
A o> ( weeee- J Appssos= KIND C=] ve2-- DISK  seereerr--ee Po seen a- 


See Dion Soe serss SSS2sesesS% 1 
wef A: geen HOSP rlab <sys tear. d= l> -es2sseer { 
Recent eee teem ew net es Bese a nee Te Se eT eee tw ewe Sete TB TOT eee Mw we ee ee wee 
i 
bess: 10 Ste seseese=s == a a eo a wm 
I--- <volume-2> -~-] (sees 
[Se Se ser sess Sr Sse See ae Ses Ses eee es ! 
! | i 
Eine iC IRS sae Od, Sr seer= KIND C2) === sF DISK RSS J) SSS = 
! I i-~ PACK ~-f fF 1 | 
1 [== TAPE =e OF I 
1 1 Pee TAPEY s=40 od 
I ! f-~- TAPED wwf 1 
' ! I-- PETAPE --! 1! 1 
t I tol 
I Jnm= DISK sete tesenece see sennnn 1 
1 ! 
I--/ 2/777 HOST C=] <systemtide2> --rcrtecc- ! 
D ae seen ea Bwana anaanaw ae ee antanawoaca a See ee RB ewes Been Bee BH BBs Dew eee oes 


f-- Z <comments> =~] 


The <usercode part> syntax is shcwr in the following syntax 
diagrémie 


USTER] C=] --"-- <Usercode> “sss s2=s="s=s""- oe ae ae ee aN Se eS =| 
! I--- » PASSWORD C=] <password> ~~~! 
i | ! 
Im--- <usercode>/<passnord> qrerrrrere Se a ee | 


Semantics: 


AS Inforas the server"system tc create a new file 
with the name specified as filename-2. If the 
file is nresent on the server-systems the command 
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BINARY 


FILE 


filenane-1 


fitenane-2 


KIND 


List 


is aborted. 


Applies to data files and causes the SYCOM program 
to expand all the records in a file prior to 
transmission. Code tiles are always expanded. 
The BINARY option allows users to transfer files | 
to and from an ASCII system. If the BINARY option 
is not specified fcr a data file transfer to a 
non-EBCDIC system» the SYCOM progras changes 
non-graphic characters to question mark (?)- 
characterse The graphic character set is the 
EBCDIC representation of the 95 valid ASCII 
characters and the nudil character. 


If a data file’ is sent to a CMS system CASCII 
machine) with the S8INARY option specifiedr to 
retrieve the same file and maintain file 
integrity» the ADD cossand sust include the BSINARY 
option. te 


Allows SYCOM to read the names of the fileC€s) to 
be transmitted from the file» <filename-1>. By 
using the FILE option» a series of files can 
transeitted by one ADO statement. Each filename 
aust be entered on separate records in the file. 
I€ the destination filename is to be different 
than the source filerase» it is entered following 
the source filename separated by at least one 
blank. Comsents can fotilow the last filename on 
the record starting with a percent sign ("2"). 


Specifies the name of the file to be transamitted. 
The filename can be a single file or a family of 
files in the format: “<asultifile-id>"/=. 


Assigns the name tc be given to the file on the 
destination system. The filenase can be a single 


file or a fasily cf files in the format: 
"<multifile-id>*/=. 


KIND is a keyword which is used to describe’ the 
peripheral device of a file. The KIND keyword is 
not required if the file is on disk. 


Inforgs the receiving systes that the printer 
backup file is to be printed after transmission by 
Zipping a corsgmand to the SYSTEM/BACKUP prograa iif 
the MCP autobackup option is set. 
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NO Overrides the default LIST attribute and is aonty 


valid for printer backup files. 


REMOVE Causes the file te be removed from the sending 
system after tne transfer has been completed. 
REMOVE is the default fcr printer backup files. 


SAVE Ensures that a orirter backup file is saved after 
the file is transferred on the sending system. 
SAVE 16 the default fcr non-printer backup fite 
transfere we 


SKIP <n> Specifies how mary files to skip if the "ADD 
<multifile-1td>/=" or the indirect CFILE} option is 
usede The first “<n>" files of the family are 
skippede Usage of the keywora is optional. 


systertidul Specifies the system identification of the system 
from which the file is to be transferred trom. 


systertid72 Specifies the system icentification of the system 
that is to receive the file. 
Taentifies the user fcr the purpose of verifying 
access rights to the srecified filename. 


volume7l Specifies the odacktic or taperid for the source 
file. This optton is not required for. fites on 
the system disks» cr aif a packwid appears in 
<filename-1>. "DISK" is used to indicate’ the 
System diske 


volume-2 Specifies the pack-id or tape-id for the 
destination file. This option is not required for 
files on the system ciske or if a packrid appears 
in <filenamerZ>. 


{ 3 Parentheses are key cheéracters when using a US» NO 
LIST» REMOVE» or SAVE option. The options can 
appear in eny crder within the parentheses. 


* Assigns tne fitenafe specified in fitename-i_ to 
filename-2. 


Examples: 


eAND XYZ CUS=US/PASS) FROM COLSKe HEST=USER1) TO COISKs HOST=SERVERT) 
eADD OMPALL AS DUMPALL FROM CHOST=FLAs» KIND=TAPE) 

eADD SOL/= AS SOLNEW/= FROM CHOST=HLS) 

eADD RELEASE CFILE> NO LIST) TO CHOST=HUGB) 

ADD = CUS A/Be SKIP 123) TO CHOST=LSER3) 

eACC RELEASE CFILE» SKIP 9) TQ CHOST=LUSERS) 
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Examples one and two are exanples of single fite transfer. 
Example three is an example of a transfer of a family of . files 
and exagsple four is an example of usirg a List of files to effect 
a transfer. Example five is an exaaple of using the SKIP option 
when transmitting a family of files. Exagple six is an exaaple 
of using a list of files with the SKIP option. 
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BUFFER 

fhe EUFFER command causes the SYCOM program to change or 
interrogate the buffer size for sending file transfers. The 
buffer size is specified in bytes. The mirigwum buffer size is 


362 bytes and the maximum is 1950 bytes- If the BUFFER narameter — 


1S not specified in the parameters file» the buffer size defaults 
to 1550 bytes. 1 oe . 


The receiving tuffer size 1s atways i950 bytes. 


if the buffer size is changed with the BUFFER commands the new 
value is effective until another SUFFER command is entered or the 
SYCOM program goes ta and-af~job. The buffer size for the next 
execution of tne SYCOM orogram reverts hack to the value 
specified by the BUFFER parameter ir the SYCOM parameters file. 


This parameter can onty be interrogated by a workstation. A 
remote OCT or the system CDT can change the vatue of this 
parameter. . 


syntax: 
eSUFFER EP BEN TSS SPOS BTS TET HE DEBE ass SHEE BeOS OOS ww ew 8 ee ee ee eee oO 
(== S024] i-- <integer> oo] I-- 2% <comments> 71 
Semantics: 
integer Specifies the nushber cf bytes for the buffer used 
in file transfers. The value must be between 162 


and 1950+ inclusivee 


eEUFFER = 400 
eBUFFER 19590 
eEUFFER Queries the currert transmission buffer size. 


The receiving buffer size can also be 
interrogated hy ertering the LIST PARAMETERS 
command to the SY¥COM program. 


DN TH NR 
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BYE 


The YE command causes the SYCO* frogram to log-off the current 
user from the SYCOM program. [It is valid from all stations 
including the systes ODT and application programs. If the user 
is connected to the serverssystes SMCS by way the CONNECT 
commands an automatic DISCONNECT is initiated. If the terminal 
is not owned Cy the SYCOM program» a DETACH wessage is sent to 
the tocal SMCS. Also» the pseudo"signal character is reset to. 
default pseudocsignal character. 


oyntaxs 
I-~ 2% <comments> “1 
Exaaples 


BYE 
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CL (Clear Device) 

The cL command causes the SYCOM program to clear ae peripheral 
device if the device beccmes troperable while receiving a data 
tite. The buffers associated with the specified device are 
cleared and the receiving process is terminated. 


This command can anly he entered free a remcte ODT or the system 
OOT. | : 


oyntex: 


Semantics: 

LP Clears the line orinter. 
tP rears the are ere 
Examples: 


-CU LP 
CL CP 
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CONNECT 


The CONNECT command causes the SYCO*¥ program to Logon a terminal 
user to the server~system SMCS. 


The SYCOM program ensures that a WCS“type program is running in 


the servervsystea and that a virtual station stot is avaitabte 
before making the connectior. 


If aeuser is logged~on to the SYCOM progrargs then that user's 
usercode/password is forwarded to the MCS tn the other systean 
which automaticatly logs the user on tc that MCS. 

If switched data communication Lines are being used» an Automatic 
Catling Unit CACU) is present» and a telephone number is 
proviced» then the SYCOM program initiates the dial-out. 


Syntax: 
sCONNEC] soe 804 3393 e388 $ 89S S eS 6 <8 6 SSS SSS SSeS 68 Se SS eee ease a ese a= | 
im-- 2% <comments> --1 
Exaaples 


CONNECT 
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COPY 
The CUPY command causes the SYCC prograt to initiate a file 
transter. The command syntax provices for the transfer of files 
from the initiating system tc arcther system and from another 
System to the tnittatina systea. The files can be in either 
magnetic tape or cisk fort. Tf the destination file already 
exists at the recetvirg system, it will be removed and reptaced 
by the transferred file. 
syntax: 
SCOR SEALS eS Fe ee eee ie ee eee ames rae eee ee en na ee ee > 
I | 
| <2 s 3 =< p Sees ss ese Seen eee = == | 1 
| H . j ! 
[eet sss s2 4 1 fm" <usercode part> --~ ) --1 
j ! 
tes). 1... fa2Ss3s4-S4-= LIST «1 
i ve WO! =a4 j 
H | 
f--/ | farcteee REMOVE <---= J 
[(s=) 2 ferss=s SAVE crrrr ! 
(27.1. Jesse 2 SKIP <n> ---1 
j--/ ] fmosere ELLE. eas4 >see | 
aaa aad ea haa Na cna a a aa a a ae eh al aa nal a aca > 
{ ] { { i ! 
}- BENARY -1 t= AS “-"- <filename2> -1 Im C<usercode part>) -1I 
1 i 
jase <= ae eee emi ] 
> 2m on a om a oe anew @a anew SB aeawenmaeawenwewaewrewaee swat ae eB aes ee BE EB OES Se SS we aoa eee we wee ws ee B 
| 
i--- FROM wen anna annem vwewaanan ewe ae a ns en ewan amaegwet]8s ea ee a su eae asa weweaeaw ag A 
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| Kon errr nnn n nce nne 9 cee ene nena nnn --------} 
| i 
A e- ( seer 1 feoteem KIND C=] e222" DISK ceeeceeeeen= ) ------- B 
! I-- PACK "1 11 


! 

{ { i-- TAPE “-f 1 
! i i-~ TAPE? w~-i ¢t 1 
t ! 1-~ TAPED wrt fT 1 
i 1 Im-~ PETAPE ~~! 10 1 
i 1 i | 
1 ! 14 
! i 
1 


os oe DISK om ne De a ew ae ee oe at a ae oe 


--/ 1 /--* HOST C=] <systen-id-1> ---------1 
B anew Dew anwansa @aanwe Ben awoaunnmanaaa ws SSB OE BES SOS TSB SOO BD aenawesna waa e D 
I 
[ane 10 corer ence nnn nee n nnn nnn----- stata tatataiatatebatatatasiatetatatatetaratatanetatatetetate c 
f--- <volume~2> ~~~! P---=. 0 
1< wenenena nan auawe a naeeawan 9 cee nese see semen seca | 
; 1 
a e/ A feeeeee KIND f=] cress DISK 9 -<+--------- ) ------- D 
4 i-- PACK == 4 


Ie TAPE aoe | 


tt 

1 11 
1 a 
1 — Yr= TAPED w--! 1 1 
i 14 
1 11 
1 1 oi 
! 


—_ a DISK — = on oe oe ea uaea a _— a ee os = 
~-/ 1 /--- HOST C=] <systemsride2> es "3--7--- 1 
D Sn i SS: a hae Si Oa ee em 8 waaaaunwa ea Danae n Dean vanawe wae e elated | 


i-- 2% <comments>?> “7! 


The <usercode part> syntax is shown in the following syntax 
diagréne . 


USTERJ £=] «c--- <usercode> -"*"-* 2 oem ewww none neem naan sor aeeaee o<e==] 


{ te-= » PASSWORD C=] <password> --~| 
I | 
i--- <usercode>/<password> w eeerrerr"- ea | 


Semantics: 


AS 
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Informs the server=system to create a new file with the name 
specified as filename-2. If the file is present on the 
server~systems» the command ts aborted. 


BINARY 

Applies to data files and causes the SYCOM program to expand 
ail the records ina file prior to transmission. Code files 
ere always expanded. The @INARY option allows users to 
transfer files to and from an ASCII system. If the BINARY 
option is not specified for a data file transfer to a 
ron-ES8CDIC systems the SYCOM program changes non-graphic 
characters to question mark (?) characters. The graphic 
character set 1s the EBCDIC rerresentation of the 95 valid 
ASCII characters and the null character. 
If a data file is sent to a CMS system CASCII machine) with 
the SINARY option specified» tc retrieve the same file and 
maintain file integritys the CCPY or FETCH command must 
include the BINARY option. 


FILE 
Allows SYCOM to read the rares of the file€s) to be 
transmitted from the file» <filename-1>. By using the FILE 


cptions a sertes of ftles can transmitted by one COPY 
statement. Each filename must be entered on separate 
records in the file. If the cestination filename is to be 


cifferent than the source filenége» it is entered following 
the source filename separatec by at teast one blank. 
Comments can follow the last filename cn the record starting 
with a percent sign ("2%"). 


filenaze-1 
Specifies the name of the file to be transmitted. The 


filename can be a single file or a family of files in the 
format: “"“<mnultifiletid>*/= 


filenane-2 

Assigns the name to be given tc the file on the destination 
Systeme The filename can be a single file or a family of 
files in the format? “<multifile-id>"/=. 


KIND 

KIND is a keyword which is used to describe the peripherat 
device of a file. The KIND keyword is rot required if the 
file is an diske 


LIST 
to be printed after transmission by zipping 4a command to the 
SYSTEM/BACKUP program if the MCP autobackup option is set. 
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nO 


Cverrides the default LIST attribute and is only vatid for 
printer backup files. 


REMOVE 

Causes the file to be removed froma the sending system after 
the transfer has been completed. REMOVE is the default for 
erinter backup filese 


SAVE 

Ensures that a printer backup file is saved after the fite 
is transferred on the sending systen. SAVE is the default 
for nonwprinter backup file transfer. 


SKIP <n> 

Specifies how many files to skip if the “COPY 
<gultifile~id>/=" or the indirect CFILE) option is used. 
The first “<n>* files of the fawily are skipped. Usage of 
the keyword is optional. 


systea-id-1i a 
Specifies the system identification of the system from which 
the file is to be transferred frose 


systea~id-2 
Specifies the systera identification of the System that is to 
receive the file. 


usercode and passuord 
Identifies the user for the purpose of verifying access 
rights to the specified filenare. 


volurse-i 
Specifies the packwid or tape~id for the source fite. This 
option is not required for files on the system disk» or if a 


packtid appears in <filenawme-1>. "DISK" is used to indicate 
the system disk. 


, voluse-2 


Specifies the osckeve or tape~id for the destination file. 
This option is not required for files on the system disk» or 
if a pack-id appears in <filenase-2>. 


| i 

Parentheses are key characters unhen using a US» NO LIST» 
REMOVE» or SAVE optione The options can appear in any order 
within the parenthesese 


& 
Assigns the filename specified in filename-1 to filenane-2. 
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Examples? 


Fd 


-COPY XYZ CUS=US/PASS) FROM CDISKs HOST=USER1) TO CDISK» HOST=SERVERDD 
-COPY OMPALL AS DUMPALL FROM CHOST=FUB> KIND=TAPE) 

COPY SDL/= AS SDLNEW/= FROM CHOST=HUB). 

-COPY RELEASE CFILE» NO LIST) TO CKOST=HUB) 

-COPY = CUS A/B» SKIP 123) TO CHOST=USER3) 

-COPY RELEASE CFILE» SKIP 9) TO CHOST=USER5) 


Examples one and two are examples of single file transfer. 
Exaaple three is an examole of a transfer of a family of files 
and exaeple fcur is an example of usirg a list of files to effect 
a transfer. Exampte five 1s an exaaple of using the SKIP option 
when transmitting a family cf files. Example six is an example 
of using 4 tist of files with the SKIP option. 
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CP NR (Card Punch Not Ready) 


The CP NR command causes the SYCOM program to infora the 
user=systeem that the system card punch is in a Not Ready state. 
The SYCOM program in turn inforas the server~system of the 
condition of the hardware. The serversysten suspends 
transeitting any card punch data stream messages currently in 
processe . 


It is the responsibility of the user-system operator to infora 
SYCOM when the card punch is Ready tc receive output. 


This command can only be entered from a remote ODT or the systes 
ODT. | 


Syntax: 

eCP NR ewer ee ee sete Ss Seema eee Ce eS ENS SABA eee SB eee wees ee { 
l-- % <conmments> --l 

Exaeples 


eCP NR 
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DEBUG 


The DEBUG command causes the SYCO™M rograa to print atl data 
messages read or written by the SYCOM progras. If no option. is 
specified» a request for the current status of the DEBUG facility 
is displayed. 


This parameter can onty be interrecgated by a workstation. A 
remote ODT or the system ODT can charge the setting of this 
parameter. . 


Syntax: 
SOL ELG Ses Sse ee ee eee eae ees SASS AS SSS eS ea Se SS eS SSeS l 
f=="OFE <4 l-- 2% <cosgerts> --] 
i-- CN == 
I-- CUMP --1! 


Semantics: 


OFF Terminates the debugging option. 
ON | Starts the debugging cption. 
DUMP Causes a dusp and List trace of the SYCOM program 


to te initiated. Alsc» a siwiliar request is sent 
to the remote SYCOM frograa. . 


Example: 


-DEBLG 
DEBUG ON 
e-DEBLG OFF 
-DEBUG DUMP 
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DISCONNECT 


The DISCONNECT command causes the SYCOM program to terminate a 
session with a host server~systen. The terminal is tlogged-off 
the server-syster when a DISCONNECT message is sent to the other 
systems. The terminal reverts back tc its previous state of being 
signed on to the SYCOM progran. The terminal user is then free 
to enter more commands to the SYCOM crogranm. 


Syntax: 


eDI SCONAECT SS Oe ee ee ee ee ee te ee ee re aaa | 
| I-- Z <comments> --I 
Exarple: 


DISCONNECT 


The pseudocsigqnal character aust be inctuded in the DISCONNECT 
commard> otherwise» if the tersinal is connected to the the 
remote systems» the DISCONNECT cossgard is sent directly to the 
remote system SMCS and the following wsessage is displayed or it 
can be sent te the apnlication neegras that the user was siqned 
On £0. 


>> ERROR: MCP REJECTED ZIP CONTROL STRING 
INVALID MNEMONIC=DIS 


The current pseudorsignal character is mot changed by the 
DISCONNECT co#mand. Cnly the BYE or SIGNAL SYCOM commands or the 
*#QOFF SMCS command causes the pseudo~signai character to be reset 


- to the default pseudo~signal character. 
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EOJ 
The ECS command causes an orderly shutcown of the SYCOM program. 
No commands are processed -after the EQJ command is entered. The 
message PLEASE SIGN OFF is broadcast te all terminals currently 
egged~on te the SYCOM prograa.- A clase message is sent to the 


other system's SYCOM program after the coepletion of any 
in~process file transfers and when there are no longer any 
terminats cennected to the remote systeme- The SYCOM program then’ 


sends a discannect gessage to the retwork cortroller and goes to 
endo f~ job. 


this command can only be entered free aremote ODOT or the systea 


ODT. 
Syntax: 
2bE0J we reine canteen eneie sna ek a senna wantaawes seertrteetiedinedinecien niente nae teinien 
b-~ PIT) e482 ies % <comments> -~I 
== x7 eed. . me 
Semantics: oe 
D auses the SYCOM program to initiate a dump. 
OT Causes “the SYCOM procram to initiate a dump and a 
List trace. 
xT Causes the SYCOM program to inttiate a List trace. 


The bee aa character represents any non-blank 
character except the "0" character. 


Examples: 


eEQJ 

-EQJ D £=% Causes a dump. | 

e-EOQJ ODT % Causes a dump anc List trace. 

«EQS xf % Causes a list traces. The “x™ character represents 
z 


any nonmbiank character exceft the “DBD” characteér. 
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FETCH 


The FETCH command causes the SYCOM program to initiate a fite 
transfer froma the server~system to the user-systea.e. This command 
is a shorthand version of the COPY cogmand. The files can be on 
magnetic tape or diske 


syntax: 
eFETCH <filename-1> corm etrernnannnn Sess e sere SSS aaa a > 
1 ) i 
1 (<er ent ig Seer ersS sss sa ealaater atras) 1 
f ! ! ! 
See eon en ere / 1 /-- <usercode part> --- ) -1 


: 1 
Pn-/ 1 feoccseenee== LIST =<! 
i I-- NO --1 1 


I--/ 1 feoem== REMOVE -----"1 
l--/ 1 /e-e-- - SAVE 9 -2----1 


I--4 1 fe----- FILE <----- --1 


> aaeuennenwenwae» asa umsneaee Ft @eaaun aaa = a e@e@uauas w= Ce ee ee eee ee OO OO Og -> 


j { 1 ii | i 

i- BINARY 1 i- AS ws~-- <filename-2> -§ I- (<usercode part>) -1 
| | i 
t= ONTO <1) 1S<Se"2 6 <s<<s=4 


[== FROM monn n ec rennnneenennnee= (KIND T=] -2-- DISK 9 ---- ) --1 


1 1 i-~ PACK stl i 
I-- <volumewt> «----1 I-- TAPE ==] ! 
i i-- TAPE? <-<-1 J 
1 I-~ TAPED <==! i 
! I-- PETAPE -~!I J 
1 i 


I-- CDISK) <<! 


Steet 
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Dare eee wee a cee were emma sce ereees aoereccesss= owe we mee wee eee ewe wwe > 
i I 
12S 19 See ese See sess one es ee == 5 CKIND C=] «+= DISK “ce- ) =] 

! i inm- PACK ~~] t 
I-- <volume"2> “"--- 1 Ii-- TAPE --1 | 
1 i-- TAPE7 =~! { 
! f-~ TAPE9 <-~-! i 
1 foo PETAPE --! | 
j 4 
| tar te cee eee teens ween ester eeteosesce i 
I-- CDISK) --] 
Dw a a rn ew ne rene eset ssesese== ot ee wee ewer = wee eee ese i 
[s— % <comments> paea | 
The <usercode part> syntax is stown in the following syntax 
diagréme 
USLER] C=] ----- <usercode> ----- aaa a ala a 
io 3 j--- » PASSWORD T=] <password> --7!1 
! t 
i=-= <usercode>/<password> “cs Pesos sees 9—s6<6s<s- ! 
Semantics: 
AS 
Informs the server~system toa create a new file with the name 
specified as filename-2. If tne file is present on the 


servercsystems» the command is aborted. 


BINARY . 

Applies toe data files and causes the SYCOM program to expand 
att the records ina file prior to transmission. Code fites 
ere always expanded. The BINARY option allows users to 
transfer files to and from an ASCII transfer to a non~EBCDIC 
system» the SYCOM program chances non-graphic characters to 
cuestion sark (7) characters. The graphic character set is 
the EBCDIC representation of the 95 valid ASCII characters 
end the rull charactere 

If a data file is sent to a CMS system CASCII machine) with 
the BINARY option specified» toa retrieve the same file and 
saintain file integrity» the ADD command must include the 
BINARY option. 


FILE 


Allows SYCOM to read the naees of the file(s) to he 
transmitted from the file>» <filename-1>. By using the FILE 


cption» a series of files can transmitted by one FETCH 
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statement. Each filename aust be entered on separate 


records in the file». If the destination filename is to be 
cifferent than the source filenazee» it is entered foilowing 

the source filename separateaq by at teast one blank. 
Comments can follow the last filename on the record starting 
with a percent sign ("2"). 


filenare-1 
Specifies the name of the file to be transmitted. The 


filename can be a single fite ora penny of files in the 
formats “<aultifile-id>"/=. 


filenane-2 | | : 
Assigns the name to be given toa the file on the destination 
SySteMe The filenage can be a single file or a family of 
files in the formats “<multifileid>"/=. 


KIND » 3 
KIND is a keyword which is used to describe the peripheral 
device of a file. The KIND keyword is not required if the 
file is on disk. 


LIST 

Inforgas the receiving systesw that the printer backup file is 
to be printed after transgissiar by zipping a comagand to the 
SYSTEM/BACKUP programs if the MCP autobackup option is sete 


NO 
Overrides the default LIST attribute and is only vatid for 
printer backup files. 


REMOVE 
Causes the file to be removed frcm the sending system after 
the transfer has been coapleted. REMOVE is the default for 
rrinter ctackup filese ; 


SAVE . 
Ensures that a printer backup file is saved after the file 
is transferred on the sending systeme SAVE is the default 


for non-printer backup file trarsfer. 


SKIP <a> | . 

Specifies how many files to skip af the “FETCH 
<sultifile-id>/=" or the indirect CFILE) option is used. 
The first "<n>" files of the fawsily are skipped. Usage of 
the keyword is cptional. 


systeatid-1 
Specifies the system identification of the system from which 
the file is to be transferred frog. 


BURROUGHS CORPCRATION 
COMPUTER SYSTE®*S GROUP 
SANTA BARBARA PLANT 


system "id-2 


Specifies the system 


receive the file. | 


usercode and password 
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identification of the system that is. to 


Tdentifies the user for the purpose of verifying access 
rights to the specified filename. 

voltuse71 

Specifies the packid or tapetic for the source fite. This 


cption is not required for files on the system disk» or if a 


racktid appears in <filenaner1>. "DISK" 


the system disk. 


voluse-2 


Specifies ‘the pack-id or taperid for the 
This option 


if a packwtid appears in <filenase-2>. 


(3) 


Parentheses are key apie cake when us 


REMOVE» or SAVE cption. The ontions can 


within the parenthesese 


rd 


Assigns the filename specified 


Examsples: 


eFETCH 
FETCH 
eFETCH 
eFETCH 
eFETCH 
eFETCH 
eFETCH 
eFETCH 
eFETCH 


FETCH 
eFETCH 


»FETCH 


DMP ALL 

DMPALL FROM USERI TO USER2 
USER/COBOL/= TO DISK. 

COECL/= TQ USER 

= CUS A/Bs SKIP 99) 

RELEASE CFILE» NO LIST) 

SYCCM AS HUB FROM PACKA TC PACKS 
PACKA/SYCOM/ AS PACKS/HUBS 

SDL/= AS SDLNEW/= TO PACKE 


= (US A/B» SKIP 9) 
PACKD/COBOL74/= 10 DISK 


COEQL74/= FROM PACKD 


ne xe 


4 
z 


z 


is used to indicate 


destination fite. 


is not required for files on the systea disk» or 


ing a US» NO LIST» 
an appear in any order 


ir fitename-l to filenane~2. 


same as following example 
same as preceding exaeple 
transfer of a family of 
files 

alt CA)/= except first 9 
files 

"DISK" as volume id means 
system disk 

same as oreceding example 


The first example will use the sae destination name as the 


source NaRmee 


the syster 
ail the 


The second example uses different pack ids. The 
third example takes a family of files from a 
systege diske 


user pack to the 
The fourth exauapte transfers a family of files from 


disk to the npack USER. The fifth example will fetch 


files uncer the usercoder» “Ae 


except the first nine. 


The sixth example is an example of using a List of files. 
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: GROUPSIZE 


The groupsize command displays or changes the groupsize used for 
dividing fasilies of files into grours. 


The groupsize is used to restrict the number of files that wilt 


be sert a one time when sending ar ertire fasily of files Ci-.e. 
PUT SYSTEM/=). . 


This parameter can onty be intereogated by a workstation. | A 
remote OCT or the system ODOT can change the vatue of this 
parameter. 

Syntax 


eGROLPSIZE Cec eee ae Ome Se OE TAO OTS 8s DOB ee es Tet ewes as eeaesececeoe | 


t i 
Semantics: 


integer One or two digit integer value between one and 99 
that represents the rew value cf the groupsize. 


Exaaple: 


eGROUPSIZE 
eCROUPSIZE 15 


BURROUGHS 


COMPUTER § 


SANTA BARB 


LIST 

The LIST c 
userse 
signed on» 
transfers 


Syntax: 


Semantics: 
OLDTRACE 
PARAMETERS 


PUTQUEUE 


SCHEDULE 


TERMINAL 


TRACE 


USERS 
Examples: 


eLIST 
eLIST 
eL IST 
eLIST 
eLISI 
LIST 
eL IST 
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ommand displays informatior about the system and its 
Coamand options provide lists of those users currently 

terminals that are currently oan-line»s and fite 
that are currently scheculed to occur. 


CLOTRACE 

_ PARAMETERS 
PUTCUEUE 
SCHEDULE 
TERMINALS 
TRACE 
USERS 


i-- Z% <comments> --! 


Prints the Last trace fite created by SYCOM. 


Displays the parameters SYCOM is using. 

Prints the current rarce of file transfer requests 
that were initiated by a PUT requeste $$ The list 
orovides a list of up tc the tast 99 PUT requests. 


Displays. alt file transfers currently 
schedule in schedule rumber order. 


in the 


Displays att terminals that are currently on line. 


Prints the current trace file 


SYCOM. 


being written by 


Disptays att of the users of the SYCOM program. 


CLDTRACE 

PARAMETERS 

PUTCUEUE 

SCHEDULE 

TERMINALS 

TRACE 

USERS 

OLDTRACE PARAMETERS PUTQUELE SCHEDULE TERMINALS TRACE USERS 


5-32 
BURROUGHS CORPORATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP B1800/B81700 SYCOM 
SANTA BARBARA PLANT Pe Se 2219 0458 CA) 
LOG 


The LOG command causes the SYCOM program to display the number of 
occurrences of specific data corsunication line errors’ and 
certain wsessage transmission statistics. The totats in the 
counters can be initiatized if the CLEAR option is included in 
the commande , 


Syntax: 
‘Jem CLEAR --I i-- Z% <comments> =~! 


Semantics: 


CLEAR Resets the log counters and closes the statistics 
filee 
Exasple: 
eLOG 


eLOG CLEAR 


By a 
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iP 

The LP command informs the user~system SYCOM program that the 
line printer ts Not Ready. The SYCOM program informs the 
serverwsystem of this temporary concition. The serverwsystem 
then suspends transmission cof the tine printer data stream 


messages until notified to resume by the userwsystem SYCOM 
program. . 7 


It is the responsibility of the user-systes operator to inform 
SYCOM when the line printer 1s again Ready to receive output 
data. 


This command can only be entered froa a remote ODT or the systean 
ODT. . 


syntax: 


eLP AR = aewwe a ee ROO SSMS SMSO BSA SSH SB SBSMASS SAO NABMTBeEB AAs sn eannnn ae Salted | 


{+= 2 <cofiments> ==3 


Example: 


eLP AR 
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OFFLINE 


The OFFLINE command causes the SYCOM prograa to break the 
existing connection with the other systems go into standby mode» 
and wait for the other system to call back. This command can be 
used for either a switched or nonsswitched Data Comm Line 
connection. hhen a "DLE ENO” is received from the other system» 

the network controtler re-establishes the connection with the 
ether system and rorgal operations TesSumea 


This command can only be entered froe a ‘remote ODT or the system 
ODT. ae 


Syntaxe. 
oOFF LINE a mee Se ee A ae ne a ee ee ee ee ee ea re Se a Se a en ee ce oof 
I-- % <comments> --] 
Exanaple: 


e OFFLINE 
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ONLINE 


The CNLINE ccmmand causes the retucrk controller to attempt to 
rerestablish the Line connection to the server-system. 


The error wessage RETRIES“UP is cisplayed when the current 
message buffer being sent to the server~system is not being . 
receivede By entering the ONLINE ccomamands the message buffer 
being sent is discarded and an attempt is made to re-establish 
the Line connection. 


This command can only be entered frog a remote OOT or the system 
ODOT. . 


Syntax: 
eUNLINE “= =<se<e= SSeS eee Sees S SSeS Ss S= a a a ee ea a eee | 
Jj-~ Z% <comments> ar 
Fyvamnias: 
mr A a We 
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PHONE 


The PHONE command causes the SYCOM program to provide to the 
network controller with a telephone ruaber for the Automatic Call 
Unit CACU or display the existing teflerhone nuaber to a 
predefined server~system- The automatic diat-out using = = an 
Autometic Calling Unit CACU) to a specific server-system requires 
that 2 phone nuesber be present. 


This parameter can only be interrogated froe a “workstation. A 
remote ODT or the systese ODT can change the value of this 
parametere | 
Syntax: 
ePHORE eee eee mete cee e eee Cees 6 tee Cee Stee «ete ee eeee cen ene mes eee e en | 
t-- = -"f f-- <telephone rusber> --1 I-- Z% <co@ments> --I 


Semantics: 


phone nunbder The telephone nusmber cf the server-systese. The 
waximnum nusber of numeric characters is 29. 


= Clears the existing telephone nusbder. 


BURROLGHS CORPORATION 
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SANTA BARBARA PLANT 


Exarpless 


ePHONE 1°222° 3335-4444 
ePHONE = 
PHONE 
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 % Assigns 2 new telephone nusbere- 


% Clears any cprior telerhone number. 
% Queries the current telephone number. 
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PROGRAM 


The FROGRAM command is used to interrogates enable» or disable 
program input to SYCOM. 


This garameter can onty be interraogatec by a workstation. A 
remote ODT or the system ONT can change the setting of this 
parameter es 


syntax: 


ePROGRAM ~--2-""-- alla tate taal | 
| i 
[er--- ON -----1 
! 
Pooen- OFF ----1 


Semantics: 


ON Turns the program input farameter on. 
OFF Turns the program ingut férameter off. 


..Exaapless .. 


ePRCCRAM 
ePRCCRAM ON 
PROGRAM OFF 
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PUT 


The PUT commanc causes the SYCOM program to initiate ae file 
transfer from the user=system to the server~system.e. This command 


is a shorthand version of the copy ccrmand. The files can be on 
magnetic tape or disk. 


syntax: 
ePUT <filenamer1> seeerr eter srem— SS SSSceera Sa sanS=sss= nee a eae 
1 ! 
! [<°s=52== f See Se Ssh ea eee { 1 
1 { | 1 
Inm- ( seeeen-/ 1 fe <usercode part> --- ) --1 
I 1 
ees 2 sere asaerer=) £15) 
| 1-- NO --1 | 
! ! 
i--/ 1 daira: REMOVE ~--~----{ 
t==/. 41 f=-+=s= “SAVE: =e == i 
Lens. fess S== SKIP <n> --~] 
Les, A ferenss- FILE Sse se I 
>t e seen we eee oe ce we ee w eres we cee cesses wo ewe ne ee women ne oem ee em> 
| } a | | 
I- BINARY =! [| AS. s=ss= <filename-2> -1 i- C€<usercode part>) <-l 
| | on | 
{f- CNTO “1 Ierersce i masoam= j 
Ma tod pb wesc eie eee nace ecco eames. cone woe cauweeac dmc wanes > 
i . ; j 
Im- FROM ocectecsee== tatiana s---- CKIND [=] ---- DISK waonwn ) =<] 
1 . { Iim> PACK --| H 
I-- <yotlumec1> ----- 1 Im-- TAPE a=] ! 
i I-~~ TAPE? =~! j 
 In7~ TAPED =! ! 
1 I-- PETAPE --1 i 
| { 
percent ee tees eee eee ew eee wet owawtaeaawaan ti 


I-- COISK) ch | 
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>= Qu awe ee ew O28 8B CE 28828 HOAN DBTBA SST BSHRABW“SR GAH e DVT ee Bee ane wave aanaeas)> 
t | ' 
Pa TO cece rt ones nceercnececnnns (KIND [=] --9- DISK 9 enn- ) =o 


! (d-- PACK =I 1 
I-- <volume-2> -----1 : I-- TAPE "1 1 
I-- TAPEZ --1 
I I-- TAPES --1 
I-- PETAPE --1 i 
i | 1 
Jon en ene eee nnn nn ------ a alaatatetataatetatatatenal | 


i-- (DISK) --1 


> mata tee Gan aen ananes 422 2a seane mee 2 ee @& Tee ea ee eee ee ee ee = a en @ ee ew waeneaecawooe | 


I-- Z% <comments> -~I 


The <usercode part> syntax is shown in the fotlowing syntax 
diagrém. 


USLER] [=] ----- <usercode> -------99+------------------- ----------- I 
| f--- » PASSWORD €=] <password> =<"! 
1 i 


Semantics: 


AS | | | 
Informs the server~system to create a new file with the name 
specified as filename~2. It the file is present on the 


server-systems» the command is aborted. 


BINARY. 

Applies to data files and causes the SYCOM program to expand 
ett the records ina file prior to transsission. Code files 
ére always expanded. The BINARY option atlows users to 
transfer fites to and from an ASCII system. If the BINARY 
cption is not specified for a oata file transfer to a 
nmon~EBCDIC systems the SYCOr program changes non-graphic 
charécters to question waark €?) characters. The graphic 
Character set is the EBCDIC representation of the 95 valid 
ASCII characters and the null character. 

If a data file is sert to a CMS system CASCII machine) with 
the BINARY option specified» to retrieve the same file and 
Raintain file integrity» the ACD command must include’ the 
EINARY option. 


FILE 

Ailows SYCOM to read the names of the fite€s) to be 
transmitted from the filter <fitename-i>. By using the FILE 
cptions a series of files can transmitted by one PUT 


statement. Each filename must be entered on separate 
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records in the file. If the cestination filename is to be 
cifferent than the source filename» it is entered following 
the source filename separated by at teast one blank. 
Coma#ents can follow the tast tiiename on the record starting 
with a percent sign ("2%"). 


fitenanae-1 

Specifies the mame of the file to he transmitt 
filename can be a single file cr a family of files 
foraat: “<multifilet1d>"/= 


filenane-2 


Assigns the name to be given to the file on the destination 
systeme The filename can be a single file or a family of 
files in the format? “<multifile-id>"/=. | 


KIND 


KIND is a keyword which is used to describe the peripheral. 
cevice of a file.s~ The KIND keyword is not required if the 
file is on disk. 


LIST 

Inforas the receiving system that the printer ed file is 
to be printed after transmissior by zipping a command to the 
SYSTEM/BACKUP program if the MCP autobackup sation is set. 


NO 


Cverrides the default LIST attribute and is only valid for 
printer tsackup files. | 


REMOVE . 

Causes the file to be removed from the sending system after 
the transfer has been completed. REMOVE is the default for 
printer backup files. . 


SAVE 

Ensures that a Srincer backup file is saved after the file 
is transferred on the sending system. SAVE ts the defautt 
for nonwprinter tackup file trarsfer. 

SKIP <n> 

Specifies how many fites to skip if the *PUT 
<wultifitetid>/=" or the indirect CFILE? option is used. 
The first "<n>* fites cf the faaily are euneeee Usage of 


the keyword is aptional. 


systea~-id-1 
Specifies the system identification of the system from which 
the file is to be transferred free 
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systea-id-2 


Specifies the system identification of the system that is to 
receive the file. 


iwavisde and ge suaed : 


Identifies the user for. the furpose of verifying access 
rights to the specified filenape. 


voluse~1 
Specifies the packmid or tape-id for the source file. This. 
cption is not required for files on the system disk» or if a 
gacktid appears in <filenamer1>. “OISK" is used to indicate 
‘the system disk. 


voluse-2 . 
Specifies the pack~id or tapeid for the destination file. 
Thts option is not required for files on the System disk» or 
if a packeid appears in <filenare-2>. 


Cc ) 7 . 
Parentheses are key characters when using a US» NO LIST» 
REMOVE» or SAVE option. The options can appear in any order 
within the parentheses. og : 


a 
Assigns the filename specified ir filename-1 to filenane-2. 


Exagpless: 


eFUT DMPALL 

oPUT DMPALL FROM USERL TO USER2 

ePUT USER/COBOL/= TO OISK 

ePUT COBOL/= TO USER 

eFUT = CUS A/B» SKIP 9) 

ePUT RELEASE CFILE» NO LIST) 

e@PUT RELFILES CFILE» NO LISTe SAVE) 
Z% file RELFILES contains List cf files toa be sent» with 
% destination names if different from source namese NO 
2 LIST will prevent automatic AP at destination end if 
% these files are reauired tc be on disk for a subsequent 
SYSTEM/COPY to release tape. ; 


The first exaaple will use the same destination name as the 
source name. The second example uses different pack ids. The 
third example takes a family of tiles from a user pack to the 
gyatee disk. The fourth exaaple trarsfers a family of files from 
the system disk to the pack USER. The fifth exampte witt put atl 
the files under the usercoder “"A"» except the first nine. The 
Sixth example is an example of using a list of files. 
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QS (Queue Size) 


The ¢S command causes the SYCOM procram to change or interrogate 
the GLELESIZE parameter. If the 9S ccamand is not followed by a 
equal sign or numbers the current value is displayed. If the QS 
command is followed by a number between 4 and 15s inclusivee the 
SYCOM program changes the QUEVESIZE parameter accordingly. 


If the QUEUESIZE parameter has been changed by entering the 95 
cemmard and the SYCOM program goes tc end~of-jobs» the value of 
QUEUESIZE parameter reverts hack to the value specified in the 
parameters file. 


The ecual sign C=) character is cpticnat for the QS command. 


This parameter can only be interrogated by a workstation. 
remote QCT cr the syste# ODT cé@n change the vatue of this 
Pparametere | 


Syntax: 


AQS fete neat een cen n cen n ncn econ access cnn ewes cece serene sn ce csenenna| 


Semantics: 


= Optional key character which can be used when 
changing the value of CUEUESIZE.. 


integer One or two digit irteger value between 4 and 15 
which assigns the rew cueue depth Limit. 


Exagrples; 


e€S=9 
e€S 12 


CS % Cisplays current value cf the queuesize and 
% associated marker of fsete 
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READ 


The READ command causes the SYCOM pregram to open aie card~image 
file and. begin transmitting the data to the host system. When 
end-of-fite is detected» the carc~itaage file is closed» One READ 
coamand is required to read each carccimage file. 


The READ coamand is only valid if the SYCNM program is property 
logged~on to the host syste. It is possible to override this 
feature by entering the RY CR Cready card reader) command to the 
SYCQM pPnavans 


All noan- graphic characters. are replaced with the question mark 
¢?) character. ; . 


“This comand can only be entered frow a remote ODT or the system 


REA Sr Sssss ses eeses=Sess5ee=>5=- SSeS eo Ssess-ss— SS Sersscne==sa=s5 


i-- <filename>: --1 I-7 <device type> --! I-- Z <comments> --! 
Semantics: . 


fFilengme Specifies the tabel cf the file. § The SYCOM 
progras uses the filerame specified to locate the 
file on the designatec device type. The filenaae 
must have no embedded blanks. The default file 
name is RJE/CARDS. 


device tyre Specifies the type af device the SYCOM program is 
to read from. Allowable entries are DISK or blank 
(card reader device). The default device is CARD. 
If the packrid is included in the filenawer DISK 
is assumed as the device type. . 
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Examples: 


eREAD SOURCE 


eS 


Carc cevice is assumede 


»READ USERPACK/SOURCE/FILE 


% Disk device 1S assumed since 

% there are two slash (/) characters. 
oREAD DISK /FILE NIsk Z Disk device is required since 

% there is one slash €/) character. 
eREAD Z% The filename defaults to RJECARDS 

% and device type defaults to 

ZX CARC.READER. 
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RESTART 


The RESTART cosgmand causes the SYCQ program to reinitialize, 
break the data communication connection to the other systems 
flush the PUTCUEUE» and go into a standby state and wait for a 
connection to be iritiated» by entry of either the ONLINE or 
CONNECT commard to the SYCOM prograsr. | a : 


If a schedule nusater is supplied» the  SYCOM  prograa 
 rewestablishes the connection with the other system and restarts 
the file transfers beginning with the supplied schedule nusber. 
Only the last 99 PUT commands in the PUTQUEUE can be restarted. 
Therefore» that the schedule numbers available for restarting are 
between the current PUT schedule nuster less 999 and the current 
PUT schedule nuaber. If a minus sicn (-) character appears in 
front of the schecule nuabers then the SYCOM program begins 
transferring atl of the files in the PUTQUEUE starting with the 
current PUT schedule nuaber less the number specified in the 
RESTART comaance 


If a clus sign (+) character appears in front of the schedule 
number » ther the SYCOM program begins transferring alt of the 
files in the PUTQUEUE starting with the current PUT schedule 
number plus the nuaber specified in the RESTART comeand. 


This command can onty be entered frcs a rewcte ODT or the system 


ODT. 
Syntax: 
eRESTART Ne ee ee rs ee ae ee ae ene ae ee ee ae en ee ee 
' i 
J wee eee tees ece ee owe eee 28 8 288 ee 8m 2 eee eee <integer> moms 
i le= <minus sign (-) character> --1 i 
1 tte-- <ptus sign (4+) character> ---1 i 
i | ! 
l-- RESET “Aes See ee Sa ee mo wee ewes coe sew e= | 
PO te we OR OO 8 ee Oe COE OT 8 ee Oe 88 eee Oe se eee see eee et een ee ees eeemne |] 
im- % <comments> -~i 
semantics: 
winus sign The wirus sign (“) character. 


plus sign - The plus sign C#) charactere — 
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integer 


RESET 


Exagples: 


eRESTART 
eRESTART 12 


eRESTART =5 


eRESTART +3 


eFESTART RE 


Specifies the number (located in the PUTQUEUE and 
can be interrogated ty entering the LIST SCHEDULE 
SYCOM command) to start the file transfers from. 


Causes the SYCOM program to disconnect and lognuof f 
atl users. 


Flushes the PUTQUEUE and goes into Idle state. 


Re~establish cennection and restart fite transfer 


teqinning with the schedule a 12 in the 
PUTQUEUE.. 


Re~establish connection ted restart file transfers 


PUTQUEUE. 


Re~establish connection and restart file transfers 
beginning skipping three file transfers. in the 


PUTQUEUE. 


z 

y 4 

Z 

yf 

yA 

Z beginning with the Last five file transfers in the 
y 4 

y 4 

Z 

Z 

% Disconnects and legstoff all users. 


SET 
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RY CReady Device) 


The FY command informs the SYCO* prograas that the specified 

peripherat device is currently ready to send or receive data. 
~The ‘SYCOM program also notifies the server~system that the 
peripheral device is ready to send or receive data. 


This command can only be entered froa a remote O0T or the systen 
ODT. 


‘Syntax? 
[e2< CP ees} I-- Z% <cosmerts> --l 
I--~ LP ---] 


Semantics: 


CR | Ready the card reader. 
cP Ready the card punche 
LP Ready the Line printer. 


Exaapless 


eRY CR 


eFY CP Z Must be entered if punch cutput is froe the 
Z B 1000 RJE/CONTROLLER progran. 


efY LP 
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SIGNAL 

The SIGNAL command causes the SYCOM program to display or change 
the current SYCOM pseudo~signalt character. This facilitates 
communication with more than one <SYCOM program. If a new 


pseudo~signal character is not specitied in the SIGNAL commande, 
the current pseudomsignat character is displayed. If SMCS is 
executing and the SYCOM user is signed on to the SYCOM programs 
Changing the SYCOM pseudo~signal character only applies to the 
one user» Leaving the SYCOM pseudo-signal characters for the 
other users unchanged. . : 


The default character for the SYCQM pseudo-signal character is 
the period €.) character or whatever character that is defined as 
the pseudomsignat character in the farameters file at 
beginning-of-job. The pseudo-msignat character reverts back to 
the default pseudowsignal character after a station is signed off 
the SYCO™ program or when the SYCCM c¢rogram goes to endcrof-job. 
A stétion car te signed off the program by entering the BYE 
comgard to the SYCOM progras or the *CFF command to the SMCS. 


FTha reandndnweinnal rharartar 
tne PSSuUGe™SI gn 


: 7 aA uh e Zia th 23 
ai Cr@racter 7S Not requires when a teraginagt is 


not ccnnected to 3 server~system. 

The SYCOM pseudo~signal character is required when entering SYCOM 
program ccsmands to the SYCOM proagrag on the system ODT and the 
syster CDT is not connected to the reacte systems otherwises the 
messace is sent to the remote systew ODT- 


syntax: 
eSTGKAL awe we & ew eo wean wae we Se Se Se a eee Ae ae Se ee a ee ee a 
I--- <pseudo signal character> ---! i-- XZ <comments> ~~! 
Semantics: 


pseudco~signal character The new pseudo~signal character for the 
current SYCOM user. . 


Exarptes: 


eSIGAAL 
eSIGNAL # 
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SIZE 


The SIZE command causes the SYCOM orcgqram toa display or change 
“the maximum message buffer size fcr transmitting and receiving 
purposes. The SYCOM program then informs the server~system of 
this change with a special systems control type message. This 
- command applies only to the RJE function of SYCOM. 


This paraweter can only be interragatec by a workstation. A 


remote ODT or the systesx OQOT cér change the value of this 
parameter. 


Syntax? 


eSIZE tamer reser s nacre serena seen scenes ecennensesnen satiate tata tatatatal | 


[-- = --1 I-- <integer> --# Im % <comments> --! 
Semantics: 


integer A 3-digqit nusber which assigns ‘the RJE buffer 


S$1Ze-6 The value aust be between 078 to 400» 
inclusivee 


Exaspless 


e SIZE=400 Z Equal sign (=) character is optional. 
eSIZE 132 
SIZE Z Causes the SYCO®*¥ program to display 

Z the current RJE buffer size. 
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STOP 

The STOP command causes the SYCOM prcgram to immediately shut the 
system down. No further input sessages are accepted and the 
SYCOM program coes to endtof~job. Terminals are not logged-off» 
virtual terminals are net discaonnecteds nor is an intersystem 
connection disconnected. Also» printer listings of the 


DISK_TRACE tile and/or a SYCO™ prcgram dump are generated» if 
requested. : 


This command can only be entered frees a remote ODT or the system 
ODT. . 


I-- xT aaa 


D Causes the SYCOM program to initiate a dump... 


DT : Causes the SYCOM program to initiate a dump and a 
list trace. 

xT Causes the SYCOM program to initiate a list trace. 
The ea character represents any non ~blank 
character except the “D" character. 


Exaeples: 


» STOP 
eSTOP OD Z Causes a dump. 
eSTCP OT Z Causes a dump and List trace. 


eSTOP IT % Causes a list traces The "I" character represents 


% any nonwblank character except the “D" character. 
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SV CSave Device) 


The SV command directs the userwsystem to inforn the 
“gservercsystem to cease transmittirg the card punch or tine 
printer data stream and to save the entire file at the 
server"systeme The SV comfanc permanently inhibits. the 
transwission cf any further card punch or tine printer data 
streams until notified by the user~system. 


This cosamand can only be entered frcs#w a renote ODT or the system 
ODOT. _ 


syntax: 
2SV¥ ccc CP tert e an ersten een nn nnn nn ccm n nnn ncaa en en en en wen nnnennnn=| 
Pe-- LP ermt fer Z <comments> --1 
Semantics: 
cP. Save the card punches — 
LP Save the Line spinbere 
Exaaples: 


o3V CP 
eSV LP 


| 5-53 
BURROLGHS CORPORATION COMPA 


| MPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP '81800/B1700 SYCOM 
SANTA EARBARA PLANT | Pe S. 2219 0458 CA). 
SYSTEKID 


The SYSTEMID command displays or changes the current value of 
SYSTEWID. If a new SYSTEMID is entered» then it is sent to the 
remote system via the appropriate SYCOM control message. If the 
Systegid has nat he entereds the system hostnames entered by the 
MCP "FN@ command will be used as the SYSTEMID. 


This parameter can only be interragatec by a workstation. A 


remote ODT or the systes ODOT cér change the value of this 
parameter. 


syntax: 


eSYSTEMID ee ee es ea vneawnenaamanaes @ Sse ana nwaweea wea ae oa-] 
, 4 
I as ee - <identifier> aa 


<identifiter> An identifier of up to seventeen characters 


containing onty alphanumeric . characters used to 
identify the new systemid. 


Exareples: 


eSYSTEMIC 
eSYSTEMID AARDVARK 
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TRACE 


The [FACE command precvides the facilities for tracing att SYCOM 
input/output messages which are saintained ina fite tabeled 


“'<DISK_TRACE. The command is only valid if entered from the systen 


“ODT cr arescte GOT station. Wher TRACE is entered without an 
attritutes the current status of the trace option is returned. 


The disk tracing facility 1s used tr conjunction with Progras 
Switch 2. If Program Switch 2 is ecual to 0» no data is traced» 
and only intersystem SYCOM prograw ccrtrol wessages are traced. 
If Program Switch 2 .is equal to 15» all data is traceds - If 
Program Switch 2 is equal to a nuaber between 0 and 15> then on 
Lines of data are entered into the trace file» where n is the 
-assigred value of Program Switch 2. 


The size of the DISK_TRACE file can. be controlted by the 
parameters TRACEAREAS» TRACEBA» and TRACERBe which default to 20» 
10» and 4» respectively. 

This parameter can onty be interrogated by a workstation... A 
remote ODT or. the systes ODF can change the value of. this 
parapweter. . ee | 

Syntax: 


eTRACE tee rat eter ee rere ne nnenn- a laletalatatatatatatalatatatateatatatatetetatetate ------ ------] 


fe-- (N =--)] l-- 2 <comments> -71 
je-= CFF -=-1 


Semantics: 
ON | Starts the tracing furction. 
OFF Stops the tracing function. 


Examples: 


e TRACE Z Causes the SYCOM program to display the 
% current status of the TRACE boolean. 
e TRACE ON | 
eT RACE OFF 


Note that the disk tracing facility is used in conjunction with 
program switch 2. If program switch 2 is equal to zeros then 
only intercssystem control messages are traced. If program switch 
2 is set ta a non-zero value» then a nuaber of lines of data 


equal to the setting of program switch 2 is traced in addition to 
the irteresystes control sessages.« 
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USER 

The USER command assigns the specitied usercode/password as the 
default usercode/password for file transfers when none is 
specified in a COPY» PUT». or FETCH command. The 
usercode/passuord is rot validated when entered but is forwarded 


to the other system when a CONNECT ccwmand is processed. 


If no usercode/password is supplied» the station is disconnected 
Cif connected) and the usercode is regaved from the SYCOM program. 
users table. This atlows the user the ability to be logged-off 
the SYCOM program without signing off. The BYE SYCOM progras 
commard signs off the SYCOM user gra detaches the station from 
the SYCOM prooran. 


The usercode and password can be up te 17 characters each for 
com#unication with nonw~81000 systems. 


Syntax: 


«USLER ) eo Se=3 2+ ><=- Ssese> “esos sesso = ee ee etait etetetetetatetet teeta. 
fr = =--{ inm- <usercode> =s00 29692 9<64s<s<<<=<4)] 
l--- /<password> ---! 


f-- 2% <comments> --!1 
Semantics: 


userccde A symbol which consists of from 1 to 17 characters 
to idertify the user. The 81000 coaputer system 
is Limited to an 8 character usercode. 


passucrd A unique string c f characters used for 
identification purposes to meet security 
requirementse 


Examples: 


eUSER ODT 
eUS COT/USER 
wile If a user is lLoaged an ta the SYCOM Orograms 
then the user is togged off- Also» if the 
station is connectecs then the station is 
automatically discornected. The station 


remains attached to the SYCO™ cprogran. 


Ye) a a ae 
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WAIT 


‘The WAIT command is used to interrcgate or change the status of 
.. the WAIT paraweter. 


fhis parameter can only be interrogatec by a workstation. A 
remote ODOT or the syste#s ODT czn change the value of this 
parametere . : 


syntax: 
oWALT SQ ge ane@aeae® 2a aes ae eee eae eae anannannana = a aa aa ic a 
d t | 1 
Sotere< ON 29942") forever £ <comments> errr 


1 
Pmceno- OFF -----1 


Semantics: 
ON Turns the wait parameter on. 
OFF Turns the wait paraaster off. 
Examples: 

oWAILT 


eWAIT CA 
eWAIT OFF . 
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oS WHAT 
The KEAT command causes the SYCOM prcgram to display the current 
status of program processing activity. The reply message from 
the SYCOM program is variable in content and length to reflect as 
many conditions as possible. If a file ts in the process of 


being transferred» its nage and the number of records transferred 
are cisplayed-» . 


Syntax: 


1 } Jnm- & <comments> =<! 


Semantics: 


U Appends the output of a “LIST USERS" command to 
the normal outout cf the "WHAT™ command. 


S$ Appends the output of a “LIST SCHEDULE" command to 
. the nermal outnut cf the "WHAT" command. 


= Appends the output ocf both a “LIST USERS™ and a 


“LIST SCHEDULE" conmard to the normal output of a 
"WHAT" commande. | 


Examples: 


oWHAT 
oHHAT 
oWHAT 


Roc 
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SMCS Coanand String from User-Systen 


This coamand syntax allows a terrinal user on the user-system to 
give commands to the server-systes S#CS for processing. Coamands | 
which are entered from a terminat and prefixed with a signal 
‘charecter of asterisk (*) are irtercepted by the network 
contrctler. anc are immediately sert to the SMCS for processing. 
Consequently» the entire range of SMCS commands is available to a 
SYCOM user with this command syntax. 


Syntax: 


<signal character> ==<-- <SMCS cogmarg> "Toc ttScrH= See ee wen seme wena | 
I--- <attribute> --<-! 


Semantics: 
signal character The anes character assigned to SMCS. 


SMCS cosmand Any SWCS eoenand which is valid from a user-sys tea 
terminal. 


attritute Any attribute that is required by the SMCS 
commande 


Examples: 


aSTATUS 
*FILE OMPALL 


oe 
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SMCS KCP Comaand String fros User-System 


This command syntax initiates directives to the user-system MCP 
fer processinge By prefixing the ccamand string with the signal 


character of the tocat SMCS» the network controtler message 
suitches this command string to the user-system SMCS which in 
turn zips the string to the MCP for processing under the 
ftotlowing rules» assuming that the terrinal is a remote ODT. If 
the ZIP option is included or the user is not logged-one then the 
commerd string is zipred ufsecureds Otherwise» the command 
string is zipred secured. 


Syntax: 


<signal character> -ecrreserrr—— <¥CP command> certo Sees ae acai aaies la 
'- ZCIPI =! I- <attributes> -1 


Semantics: 


ZLIPY Used by the SMCS toa zip the MCP command as an 
unsecured control stringe 


MCP command Any MCP command which is valid from aie work 
Station. Refer to Arrendix F in this manuale or a 
list of these MCP cofsands. 

attritute Any attribute recuired by the MCP command. 


Exasgptes: 


*Z PC DMPALL 
#Z EX DMPALL 
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SMCS Coseand String from Server-Systes 


This command syntax allows a terminal user on the userssystem to 
give commands to the server-systes SMCS for processing. Each 
commard entered must be prefixed with the current signal 
character tor that SMCS and that siqnal character must differ 
from that of the uservwsystem SMCS. ALL messages with this signal 
character ;. are intercepted by the network controller and 
immediately sent to the SMCS for processing. Consequently» the 
entire range of SCS commands is avaitable to a SYCOM user. This 
commard syntax is only valid when ar SMCS is running in the 
server~system. 


syntaxs 


 €signal character> ---- <SWCS command> -“2---------- est ace 
| es I--- <attributes> ---1 


Semantics: | 


| Signal character The character assigned to the server~systen 
; SMCS. 


S¥™CS command Any SMCS command which is valid froa a user~system 
terminal. 


attribute | Any attribute that is required by the SMCS 
coamande - 


Examples: 


$ FILE CMPALL 
$ STATUS 
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SMCS MCP Commend String fros Server-Systea 


This commend syntax allows certain MCP commands to be sent to a 
servervsystem for processing. These MCP comgmands can be entered 
from either the user~systea ODT or from one of its terminats. 
All renlies to these commands are returned to the usercmsystea 
SYCOM program which causes them to be displayed on an appropriate 
devicee. Certain MCP commands require a eusercode/passwords 
prefixed te the destred MCP commands which is known to the 
serverwsysteme This command syntax is only valid when an SMCS is 
running in the server~systeme . 


Syntax; 
<Sicnal chatecter> =*<<<<s-<=s=+> alata tatatatae aa adi oe ac > 
] a | I 
P= ZELPr Sk te 2S <usercede> “= S2seSeses4srer%== 1 
i-- <password> “"-1! 
>=aeee awe <MCP coa@and> ses eee SQ en BF Zest eB BeBe Bases — a meen om ae ee ow on oe | 


! j 
fe-rr <attributes> ---! 


Semantics: 


Signal character The signal character assigned to the 
server"systewm SMCS. Pig 


ZUIPI Used by the SMCS to zip the MCP command as an 
unsecured control strirge 


userccde A symbol which consists of from one to eight 
characters that identifies the user. 


passwerd A unique character strirg used for identification 
purposes to meet security requirements. 

MCP command Any MCP command that s valid from an ODT or 

terminal. 


ade 


attrictute Any attribute reouirec by the MCP command. 
Exaaples: 


$ MX 
£ WY 
£ US NY/USER PD =/= 
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Table 4-1 contains a summary of the functions of the SYCOM 
commands. Refer to the coamand descriptions in this sections for 
command syntax and option detail ss 


Table 4-1. Suaeary of SYCOM Commands 

Command Station punceiad 

ABORT Any. Abort a PUI or FETCH file transfer. 

ADD Any File transters CPUT or FETCH). 

BUFFER anys Irterrogate or change the buffer size 

for file transfers. 

‘BYE. Any Station log-off fros SYCOM. 

CL ooT Clear perirfheral device. 

CONNECT Any Request establisheent of a terminal to a 
server~system SMCS. 

COPY Any File transfers (PUT or FETCH). 

CP oor Infora SYCOM of Not Ready Serepherat. 

DEBUE Any® Start/stcp input/output message Pracengs 

DISCONNECT Any Request for terminal disconnect from the 
server~systesm SMCS. 

EOJ OLT Causes SYCCM to go into an orderly shutdown. 

FETCH Ary File transfers trece rue a file from other 
systea). 

GROLPSI2E Any* Sets groupsize for file ivans teres 


59763 
COMPANY CONFIDENTIAL 
B1800/B81700 SYCOM 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 


SANTA BARBARA PLANT = Pe Se 2219 0458 CA) 


LIST 


Any 


Display selective system information. 


LCG Any* Display a list of Data Comm error counts. 
LP ODT Inform SYCCP that a line printer is 
v4 Not Readye 
OFFLINE ODT Cause SYCOM to break the connection to a 
server "sysStene 
CNLIAE ODT Establish 2 server~system connection. 
PHONE Any® Establish or sine phone number. 
PROGRAM Any* Set or interrogate value of prograa 
parametere 
PUT Any File transfers Cplace a file on the ether 
system). 
Qs Any* Change network controtler queue depth. 
READ oof Qpen ard transmit card input file. 
RESTART ODT Disconnect lines initialize» and standby. 
RY ODT Inform SYCce of available peripheral. 
SIGNAL Any Change the SYCOM signal character. 
SIZE Any* Change Faximum message block sizee 
STOP ODT Cause SYCOP to shut down immediately. 
SV ooT Stop transsgitting and save file. 
SYSTEMIC Any* Irterrogate or change the value 


of SYSTEMID. 
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TRACE Any* Start/stop SYCOM I/O disk tracing. 
USER Any Log a user on to the SYCOM prograa. 
WAIT Any® Irterrogate or change the value of 


the wait p2zrarmeter. 


WHAT Any SYCOM status inquiry. 


Any = ‘Any SYCOM station 
Any* = Any SYCOM station can interrogate the 


value of this cogamarnce Only the system 
OOT or a remote ODT can change it- 


ODT The syste ODT or a remote ODT. 
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OPERATING PROCEDURES 


GENERAL 


This section provides system and terminal operating procedures 
used for the cperation of a SYCOM system with and without local 
terminalis and/or in. conjunction with the Supervisory Message 
Control System (SMCS). System operéting procedures are slanted 
toward operation of SYCOM for the purpose of Remote Job Entry 
CRJE) type functions and the asseciatec system control functions. 
These procedures present all aspects of SYCOM operations from 
initialization thru controited shutdcwre 


Locat tersinal operational procedures are separated into two (2) 


categoriess terminals under SYCC®¥ controt and terminals under 
the control of the SMCS. These procedures provide coverage of 
all terwrinal operations within the scope of SYCOM) from sign-on 
to sign-off. Actual input/output Bessage text is used in the 
exasples to provide a feel for the esse of operation 


esse of operation and what can 
be expected by a user of the system. 


SYSTEM QPERATING PROCEDURES 


The system operational procedures presented here are intended to 
provide a User System operator with sufficient information for 
operation of an tnteractive systes using SYCOM. Operation of the 
associated Network Controtler is triefly discussed. In additions 


suggestions on the use of certain basic SYCOM commands and their 
options are exemplified. 


PRELIMINARY PROCEDURES 


Before the SYCOM system is executed» the user needs to be aware 
of a few system variables that must ke considered. First there 
Gre “program switches™ which may be used to invoke certain 


optional features. Second there is the “parameters™ fite which 
is used to esaintair SYCOM*s variable control functions and 
processing attributese The folicwing procedures aust be 


performed to wake the SYCOM system operational: 
1. Set the SYCOM program switches as appropriate. 


2s Prerare a parameters disk cr card file as required. 
Coptional) 


3. Creste a CSYSTEM)/MAKEUSER file» if required for file 
security. 
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he Setup the MCP programs nage table. Coptional - for 
automatic MCP execution cf Network Controtler when 
SYC(QM is excuted) 


Se Assign system progras priorities. 


 Progrem Switches 


Progrgm Switch 0 Setting Programs Switch 0 tc 4 causes the SYCOM 
program to omit the cisplay of beginring~of-job messages until 
the link ‘to the remote system has been established. If the 
Low-crder two bits of the switch are set» the DEBUG/DISK_TRACE 
trace facility will be activated from 80J untilthe parameters 
file is read ty the SYCOM program. - As soon as the parameters 
file has been read» the vatues cortained in the parameters file 
will te used to control the OEBUG/DISK_TRACE trace facilities. 
This feature is intended to be used fer debugging purposes. 


Progrem Switch 1 If Program Switch 1 is set to 1» then the 
open-cn~-behalfrof file security mechéenism wilt not be used for 


disk files. This witt cause SYCOM to use the Mark 7.0 file 
security mechanisms. This switch is only examined when 
processing operatcr inpute Chancing procram switch 1 to any 


value than 1 will restore the norwal mode of operation with file 
securitye 


Programa Switch 2 Prograw Switch 2 is onty valid when the TRACE 
parameter is specified in the parameters file or the TRACE ON 
command is entered to the SYCOM prograe at the system ODT. ; 


Settirg Program Switch 2 to 0 causes the SYCOM prograsg to trace 
intersystem SYCOM control messages orlye Setting Program Switch 
2 to 15 causes the SYCOM program tc write all messages and data 
Lines to the CISK_TRACE file. Settirg Programs Switch 2 to a 
value between O and 15 causes the SYCOM programs to write n number 
of data lines to the OISK_TRACE file>» where n is the vatues 
specified for Program Switch 2.. 


Progrgs Switch 3 If Program Switch 2 is set to 3» then the output 
from the SERVER stations is included in the CISK_TRACE file if 


the TRACE option is set or in the CEELG file if the DEBUG option 
is set. 


Progras Suitch 4 Setting Program Switch 4 causes the SYCOM 
program to suppress the file transfer messages displayed on the 
sySter ODT. The value of Progras ‘Switch 4 determines which 


g@essage is to te suppressede The sessages that can be suppressed 
follow. 
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Message a a ee 

Number File Transfer Message 


1 FILE "“<filenamwe>* START SENDING 

2 FILE "“<fitename>*™ START FECEPTION 

3 FILE “<filename>*™ SENT <n> RECORDS 

4 FILE "“<filenawe>™ RECEIVED <n> RECORDS 


Table 3-1 shows the possible combinations for suppressing the 
file transfer messaqes. . 


Table 3-1. Combinations of File Transfer Messages 


LSS See ee Seer Se ae ei aS ae a ee > 
1 Vatue cf 1 Message Suppressec i 
| Program { (C{by message number) 1 
| Switch 4. loess ssss<ssesenen= cea | 
1Cin hexd 1 42 € 2 °-% #3 F 4 1 
Jrecteners- teoscee pone eepoeme= focenn] 
! aGa H } i i i 
i i i 1 i 1 
i aia | J ] i x 3 
] | 1 | i j 
! @2a i i 1 XxX 1 ! 
1 1 1 i | I 
1 23a } | ix ft x 4 
I i 1 i i | 
1 a4a I } xX J 1 1 
i : i | | i i 
1 25a ! 1 x 4] ! x 
J 1 ! 1 1 1 
i 36a 1 1 xX § XxX f§ J 
! ! i j l i 
I a7a i ' xX F KX FY *® 41 
| { I t 4 4 
1. 38a 1 x 4 | 1 i 
1 1 ! 1 1 ! 
1 a9a $ xX 4 i 1 x 4 
i i i i i i 
I a@Aa 1 x 4 {[ xX 4 ! 
1 1 | i i 1 
1 aBa i x 4 i xX & xX 49 
I J I | j ] 
{ aca ; X fF XxX J j J 
1 ! 1 J ! i 
] 20a '| xX tt xX 45 1 x | 
1 ! ! i 1 i 
1 aEa § KX ¢t§ X¥ § X 4 t 
1 i i 1 ! 1 
1 aFa bi X § X FF KX F§ X¥ | 

, + 
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The “X* indicates that the wsessage is suppressed. 


If Prograr Switch 4 equals a0a>» then no messages are suppressed. 
If Pregraws Switch & equals d@Fa» then all the messages are 
suppressed. 


Program Switch 4 only applies to the local SYCOM program and does 
not affect the file transfer messages displayed by the SYCOM 
program on the other system. 


Prograa abvitch 3 Setting Prograa Switch 5 to 5 causes the SYCOM 
program to automatically initiate a wmesory dump and print’ the 
DISK_TRACE file whenever the SYCCM systes appears to out of 
phase. ; a ; 


Settirg Prograg® Switch 5 to 5 also czuses the SYCOM program to 
automatically print the ODISK_TRACE fite when the file becomes 
full. The SYCOM program continues writing trace records 
beginring -at record number 1 in the CISK_TRACE file. 


Progrg® Switch & Setting Prograse Switch 6 ta 6 causes the SYCOM 
program to display the statistics of the SYCOM tog on the’ systea 
ODT whenever the DISK_TRACE file becomes full. The SYCOM program 
begins writing trace records th the CISK_TRACE file at record 
number 1. 


Settirg Program Switch 6 to 7? causes the SYCOM program to 
automatically write the SYCOM Log te the program INQ file when 
the CISK_ TRACE file beco@es full. é 


Progras anHitch Z Setting Program Switch 7 to 1 causes an entry in 
the statistics fite to be generated for files that have = been 
received from a remote System. 


Settirg Program Switch 7 to 2 causés an entry in the statistics 
tile to be generated for files that have been transmitted to a 
remote system. 


Setting Program Switch 7 to 3 causes an entry in the statistics 
file to be gererated for any file transfer that has occurred 
Ci-e- both sending and receiving). 


Workfile Naming Conventions 


The family name and pack id of the SYCOM workfiles CNEWPARAMS» 
PUTQFILE» INQ» OUTQ» STATISTICS» RJE_Q» LINK_Q» ODISK_TRACE» and 
OLDTRACE) are determined from the fawily name and pack id of the 
PARAMETERS 


The femily nase and pack id cf the parameters file are determined 
as follows: 
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le If any file equation has been sade for the PARAMETERS file 
by the operators» then the actual mame and/or pack. id 
specifiec witi te usede For exzézaple: . 


ae EX SYCOM FILE PARAMETERS PID USER.DISK3 
be FX SYCOM FILE PARAMETERS NAME USER.PARMS? 
Ce EX SYCOM FILE PARAMETERS NAME USER.PACK/HUB/PARAMSS 


The actual files mawes for the PARAMETERS file resulting 
from the file equations shown above are as fottows: 


de. USER-DISK/<sycom>/PARAMETERS 
be  USERsPARAMS | 
ce USER.PACK/HUB/PARMS 


26 If no file equation has been made for the PARAMETERS file by 
the operator» then the pack ic and the family name will be 
taken fres the actual name of the SYCOM programs. For 
exaaple: | 4 | 


a» EX SYCOM | 
be EX HUB.SYCOM 
ce EX DC/SYCOM10/SA1 


The actuat names for the PARAMETERS file resulting from the 
execution statements above are as follows: 


ae SYCOM/PARAMETERS 
De HUB.~SYCOM/PARAMETERS 
Ce DC/SYCOMIO/PARAMETERS 


Ail werkfiles witt be changed by SYCOM to have the same _ family 
name and pack id as the parameters file. Thus» many copies of 
SYCOM may be run an a single machine and the workfitles may be 
located on different packs as desired. 


Since the orly way to force prirter backup files to a user disk 
is by using the MCP "BD" commands» SYCOM cannot force the DEBUG or 
LIST files to a user packe The family name of these files is 
changed to the sawe family name as the other workfiles so that 
there will be no confusion over tke tabelling of printer files 
fron wultiple copies cf SYCOM. 


Creating the SYCOM Parameters File ; 


When the SYCOM program is executed fcr the first time or if the 
SYCOM PARAMETERS file is not on disk» a parameters file must. be 
createds. At teginning-of-job the SYCOM programs first checks for 
the parameters file on diske The actual tabel of the parameters 
file is determined as described abovee If the PARAMETERS file is 
present and of the correct versions SYCOM uses the parameters 
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specified in the disk file. If the cisk file is not presents the 
SYCOM progras checks for a card file labeled NEWPARAMS. If the 
card file is rot present the programs looks for a disk file 
Labeled NEWPARAMS. If the card file or disk file labeled 
NEWPAFAMS is present» then the SYCOM program uses the parameters 
specified in the card file to create the PARAMETERS disk file. 
If the card tile and disk file Labeled NEWPARAMS are not present» 
the SYCOM prcgram prompts the user to enter the parameters or 
"END™ Csince alt parameters have a default value) from the ODT. 


Once the parameters have been anterece the SYCOM program creates 
a disk file tabeled PARAMETERS for use the next time the program 
is executede The PARAMETERS file does not need to be recreated 
unless the file is removed. | rescved orf requires persanent 
changeSe The parameters may be changed or irterrogated for’ the. 
current execution of SYCOM by entering the farameter name and a. 
value in an ACCEPT messagee To create a new PARAMETERS files» the 

following steps should be followed: 


le Make the required changes to the NEWPARAMS file. 
-2e Remove the PARAMETERS disk file. 

“ Terminate the SYCOM prograa. 

he Reexecute the SYCOM progras. 


Refer to SYCCM Parameters» in fection 6 page 15- for a 
description of the SYCOM parameters. | ae 
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Preparing the NEWPARAMS Card Fite 


The NEWPARAMS file can be a card file. | The following is an 
example of a NEWPARAMS card file. 


2DATA NEWPARAKS 


SYSTEMID = USERI y4 

BUFFER = 1100 Z Allows 3 cede records per transmission. 
DEFALLTPSEUCDOSIGNAL & 2 Use “$" irstead of *.* 

GROUPSIZE = 1 2 Default is 9. 

NOFS % For Host RJE 

NOFTP y 4 : 

NOPRCGRAM % 

QUEULESIZE = 6 % The default value is 4. 

WAIT Z% The default is no wait. 

TIMECUTS = 0  % Default is 11. Eliminate message 
DEBUE . % Oefault is false 

TRACE % . 
TRACEAREAS = 25 % The default value is 20. 

TRACEBA = 8 % The cefautt value is 10. 

TRACERB = 5 % The default value is &. 

END % Ontionrnal. 


wPyereoet Met ek ® 


2END 


sitet tetetatel Seteatalet teleteted Satetatet etetetek teteladed tetatated totaled tatelatel taal tebeteted ‘welatatel Sete he 


The cuestion mark (7) character ir the above example represents. 
an invalid character for 80-colugn cércose The percent sign (CZ) 
character causes the SYCOM programa to stop scanning the record. 
This 2zilows user comments to be ircluded in a parameter record. 


The above example does not show all of the available SYCOM 
parameters. If a fparaweter is not specified in the card files 
then the SYCOM program uses the default value for the parameter. 


Preparing the NEWPARAMS Cisk File 


The NEWPARAMS disk file can be created by using the CANDE 
progréfie The pérameters can be entered intc the NEHPARAMS file 
in free-form format. The percent sign (2) character can be used 
to denote the beginning of comments for documentation purposes. 
The fellowing CANDE-created disk file shows what the NEWPARAMS 
file can took tikee If CANDE is used to create the NEWPARAMS 
files it may te cf type DATA or SEQDATA. 


The following is an example of a NEWPARAMS disk file. 
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Lower-case entries are allowed in parameters file for 


pérameterse 


systesid = 81885 


defaultpseduosignal & 


groupsize = 5 


buffer = 1950 


inbuffers = 5 
intuffers = 5 
prcgras 
noprogram 
nofto 


queuesize = 8 


tiweouts = 11 


nowait 


% trace 


NRNNMRNANNHNNNRNHNNAMNNRNNNMNNNMNNNHMNMRNMNMNMNNNNN NNN N MM NN HNN 


Special characters are not allowed. 
If this parameter is not specified» 
the SYCQM program will use the MCP 
HOSTNAME. . . 


Controls the SYCOM pseudo~signalt 
character. Default is ".%.. 


Controls the nusber of files that 
may be sent at one time when sending 
an entire familiy of files. 

Default is 9. 


The maxisuem buffersize is 1950. 


Nueaber of buffers assigned to 
file “IN" at BOJ. Default is 3. 


Number cf buffers assigned to 
file “IN" at BOJ. Default ts 3. 


Allows prograam~to-SYCOM functions. 
Default is true. 


Inhibits progras~to~SYCOM. 
Default is false.- | 


Inhibits file transfer. 
Default is false. 


Controls the number of messages 
that cen be written in the “LINK* 
file. Range is from 1 to 15. 
Default is 4. 


If n timeouts occurs then the 
rerwote SYCOM is consider off-line. 
Default is li. 


Prevents SYCOM from going to EOJ 
when a disconnect message is 
received. Default is false. 


Allows SYCOM to go to EOJ when 
wher disconnect message 1S 
recéeivece Defauit is true. 


Atlcws disk tracing. 
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Default is true. 
notrace Inhibits disk tracinge 
Default is fatse. 
tracerb = 4 Records=per~block for the trace 


file. Default is 4. 


traceba = 10 Blocks=per~areas for the trace 


file. Cefault is 10. 


traceareas = 20 Number of areas for the trace 
file. Cefault is 20. 

% debug Allows printer oe ee 
Default is false. 

% nets Fite separators are allowed by 
default. This farameter is used 
in conjunction with the Host RJE 
proagras which does not allow file 
separatcrse 

end Ontionsl. Signifies end of 


NNRMMNMHMNMNRNNRNNNMNNNM MMM IMM RMN NN 


parameterse 


ele tel tetel Ralhetedenl Setehetely dbeieted itetebalk tolekated tateleked Soletahed tetekedes taleteted teteatented Toabeteked,s 


Entering the Parameters Thraugh the CDT 


If the SYCO¥ program does not find a disk file  tabeled 
PARAMETERS» a card file tlabeted NEWPARAMS» and a disk file 
Labeled NEWPARAMS» the following wessage is displayed on the ODT. 


% SYCOM =<job #> ENTER OPTIONAL SYCOM PARAMETERS OR END 
Z SYCOM =<job #> ACCEPT 


The SYCOM program is then ready to accept parameters from the 
CDT. The paraseters are enterec in free-form format and are 
terminated by an “*END™ narameter. 


The parameters must be entered with ACCEPT entries in_ the 
following format: 


COM jot #> AX <parameter keywcrdq> C=<vatue>] 
{<parameter keyword> C=<value>].... 
END 


Multipte ACCEPT entries are atlloned. The sequence is is 
terminated by the "END" parameter. 
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The SYCOM program checks each parameter for syntax and validity. 
Any incorrect entry invalidates all entries in that ACCEPT entry. 
Correct the error and re~enter the ACCEPT entry. If the default 

value for a parameter is eeancee? it ts not necessary to include 
aut in oe ACCEPT entries. 


The parameters are described in Section 4. 


Creation of the CSYSTEM)/USERCODE File 


The system utility program “MAKEUSEF* is used to create and 
maintzined the CSYSTEMI/JUSERCODE fite. This file contains a tist— 
of atl valid usercode/password coabinations for the system. 
Refer to. the “Systems System Software Operational Guide” for 
detailed descriptions of the file arc its creation. 


Setup MCP Program Nare Table 


In order for SYCOMN*s Network Controller to be automatically 
executed hy the systeme it is necessary to establish the identity 
of this Contrcller in the “MCP Progras Nase Table”. To do this 
3s stapler enter the following MCP command: 


--> CM C USER/NC<etx> 
NETWORK CONTRCLLER CHANGED FROK *" TO "USER/NC" 


The controller name “SYCOM/NC” is of course 4 user optional nase 
and is therefore only representative. The actual Controller name 
selected by the user would be substituted as required. 


To verify that the correct Network Controtler I/D is in the MCP 
Name Table ("C™ slot)» the following MCP command can be entered: 


“-> Wh C<etx> 
C = *USER/NC* 


Assigning Program Priorities 


for ofptigue system response» it is recessary that the system's 
Network Controller and SYCOM run at a "high" priority. 
Therefores to ensure that the MCP autceatically executes these 
programs at their optimum priorities» the following MCP commands 
are used to permanently assign a pricrity of “15” to the Network 
Cantrcller and a pricrity af 712" tc SYCOMs 


==> MQ USER/NC PR 15<etx> 
"USER/NC" MODIFIED 


“-> WO SYCOM PR 12<etx> 
"“SYCOM™ PMODIFIED 
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Execution of SYCOMs Without SMCS 


To use the SYCOM system without the benefit of a SMCS» the system 
operator siaptiy enters the execute SYCOM command as shown below. 
The MCP automaticatly executes the associated Network Controller 
program Cproviding one is in the “C™ stot of the MCP Name Table) 
when the first remote file open is initiated for the controller. 
Both SYCCM and the Network Controller should be run at a priority 
which ensure adequate response ties to the user of the system 
Csee suggested priority values below). 


It is the option of the user whether cr not SYCOM is. executed 
With a “usercoce*. If. it is desirec to force SYCOM*s work files 
off the system disk» then it may be executed with a privileged 
userccde whose default pack=name is the desired disk~cartridge or 
disk~pack. Otherwise» SYCOM must be executed tn the manner shown 
in the example below: : 


==> EX SYCOM<etx> 


SYCOM =<job 4#> BOJ. PP=12>» MP=12 TIME = 08314:251.2 


During the beginning of the initialization phase if SYCOM canne 
locate the "SYCOM/PARAMETERS™ file or disk» it attempts to obtai 
New Parameters from a disk file Labeled *SYCOM/NEWPARAMS® or froa 
the cérd reader C"SYCOM/NEWPARAMS™ file). Should the disk file 
not te available or the carc reader "rot ready"» or if’ there is 
no card reader» then SYCOM will lapse into the mode of accepting 
the rew parameters from the systee ODT. When SYCOM is in this 
moods» the following messages are displayed in the ODT: 


% SYCOM =<job ‘P ENTER sycon CPTIONAL PARAMETERS or "END" 
sYco™ (<job #&> ACCEPT. 


The system operator can then enter the appropriate parameters to 
alter the systes's “default paraseters” (refer to Appendix Gp» 
"Parameters File Attributes"). The entry procedure is presented 
with “"Enterirc The Parameters” in this section. Although the 
“SYSTEMID” parameter is not required» in sose instancese it is 
strongly sugcested that a represertative “system identifier” be 
entered with the paraweters at this time. 


Once this file is established on disk» at need not be recreated 
unless it is lost or requires changes. Changes to the file can 
made using either of the two methods identified. Howevers agains 
it is necessary tc “remove” the existing parameters file from 
diske Additionally» this requires SYCOM to be shutdown and 
re-executed if it is currently runnirgs else all is in order. 


When SYCOM opens its Remcte Filess the MCP knows whether or not a 
Network Controlter is running and takes the appropriate action. 
That is» if a Controller is runnings then the remote file opens 
take clace and the system becomes operational. If a Controller 
is “not™ currently running» then if the Controller's name ts in 
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the "C" slot of the MCP Program Name Table> the MCP automaticalty 
executes the named Controller orcgras and the following sessages 
are displayea at the CDT: 


EX SYCOM/NC PTs. . —— 
SYCOM/NC =<job #> BOJ. PP=15»5 MP=15 TIME = 0821520867 


If there is no Controller name enterec in the MCP. Program Name 
Table» then the following nessage is cisplayed: 


REMOTE FILE “TERMINALS™ NEEDS A CONTROLLER 


The system operator aust then execute the appropriate Rerwoee 
Contrectler by entering the following command: 


<> EX SYCOM/NC<etx> . 

SYCOM/NC =<job #> BOJ. PP=15» MP=15 TIME = 08:16:01.2 
The wCP displays the above “BOJ" messages persits the Reaote Fite 
opens to occur and the systew is operational. When this 
condition exists» the following cpticnal message is displayed on 
the system ODT: | 

2 SYCOM =<job @> RUN DAY = THURSDAY 17 AUG 79 AT 08:23:31 
Upon cospletion of SYCOM's initialization phase and a successful 
connection established to a default Server System» the following 
messages will be displayed on the User ODT: 


% SYCOM =<job #> #s*e SYCOM INs002 (30 JUL 79 14253) ses 
NOW ONLINE TC REMOTE HOST = SERVERI 
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Execution of SYCOMs whith SMCS 


When SYCCM runs in ccnjunction witn the SMCS» it is automatically 
executed by S¥CS thru its “job spawning™ facititye- This cccurs 
when the “first™ terminal user "“SIGNS“ON" ofr "PASS*s® to SYCOM 
from a local terminal. Ore the system operator may start SYCOM 
from the system ODT by entering the SMCS command “START SYCOM™. 
SYCOM executed by any other method will only cause operational 
problems Cieee» 2 copies of SYCOM executing at the same time). 


Prior to SYCOM*s operation under the SMCS» an entry must be made 
In tne "S¥CS/JCBS" file for SYCOM. 4 sample entry is included in 
the “SMCS Software Operational Guide™ for this purpose under the 
headirg “Editing The JOBS File”. . 


If during the initialization phase» SYCOM carnot Locate the file 
"SYCCM/PARAMETERS"» it atterpts to cEtain new parameters from the 
disk file "SYCOM/NEWPARAMS* or the card reader CSYCOM/NEWPARAMS 
file). Should this either file not te present» or if there is no 
card readers then SYCOM commences to accept new parameters input 
from the ODT. Te sigral the system cperator cf this requiresente 


weFreew 


the fcllowing messages are displayed: 


% SYCON =<job #> ENTER SYCOM CPTIONAL PARAMETERS or "END" 
SYCOM =<job #> ACCEPT. | 


The system operator must then a fue the appropriate parameters to 
override the system's “default parageters” Crefer to Anpendix G» 


“Parameters File Attributes). The parameter entry procedure is 
preserted with “Entering The Pérameters"s this section. 
Although the Parameter “SYSTEMID™ is not required» for some 


instances» it is strongly suggested that a representative “system 
identifier” be entered with the parasgeters at this time. 


Also during the initialization phase» the following optional 
message ts displayed on the User ODT: 


2 SYCOM =<job #> RUN DAY = THURSDAY 17 AUG 79 AT 08:23:31 
Upon coapletion of initialization erd the successfut connection 
to a default Server System» the fotllcwing wessages are disptayed 
on the User OCT: 


% SYCOM =<job f> ##** SYCOM Ix.002 (30 JUL 79 14253) «#2 
NOW ONLINE TC REMOTE HOST = SERVER 


Common System Operations — 
Qnce SYCOW has been executeds froa either the ODOT or spawned by 


the SMCS» most operating procedures are coagson to both modes of 
operation. These common operating procedures are oriented to ODT 


GSrur | 
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input in the form of SYCOM parameters» SYCOQM commands» and MCP 
directivese Following then are the common operating proceduress 
oreserted in the sequence they are acst Likely to occurs under 
individual heacingse 


SMCS Signal Characters 


In order for a SYCQM systems network to function effectively» it 
is a requirement that the SMCS “signal character” for each system 
in the network to be a. different character. This can be easily 
-accoaertlished by mutual agreement when the SYCOM system network is 
desigred. . Each system's SNCS should have a specific character 
which is made known to all system userse Obviously» if the SMCS 
is not utilized» this is not necessarye | 


“If during actual system operations it is found that a SMCS signat 
character is undesirable for any reasons it can be changed while 
online. This can be aceosplished by entering a "signal character 
change coma@anc™ frogs either a tocal cr remote source. for actual 
details» refer to the “SMCS Software Cperational Guide”. 


Entering the Parameters 
The farawfeter definitions tlisted telow can be entered to SYCOM 
trom the system ODT. To do soe they can be entered on several 


Lines using the following "Acceot™ precess: 


--> <sycom jot #> AX <parameter keynord> --~ (=<value>] ------> 


eeecesaen- > [<parameter keyword> --- {=<value>].ee..] END 


Each parameter is validated and the system operator is informed 
of any illegal parameters encounterec during the parsing of the 


parameter datdae If the parameters are specified in a disk or 
card file "“SYCOM/NEWPARAMS"» then they may also extend over 
“several recorcs (Csee example). Comments on any record sust be 


prececed by a "Z". 


NOTES ALL parameters have default values. 
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BUFFER Parageter 


This parameter defines the sizes in bytes» of the used in SYCOM 
communications with the other systes.e The buffer size should be 
Large enough to handle the largest tessage» and possibly achieve 
a blocking factor for multiplies of a record. 


Syntax: BUFFER = <integer> 


The default buffer size is 1950 €3 compite time constant) and the 
maxigum alloweble size is 1950 bytes. {This parameter directty 
relates to file transfer buffer size and not RJE buffer size.) Se 
advised howevers that this buffer size must be equat to or 
greater than the maximum record size toe be transferred sultiptied 
by 2» plus 2 needed for non~data record trans hart onss 


DEBUG Paraseter 


ats ’ TEN wae eae es acheiait 
be utilized to produce a record of SYCOM's ti 


(The cefault is “no printer trace"™.) 


Syntax:  OEBUG 


DEFAULTPSEUDOS IGNAL 

The DEFAULTPSEDUOSIGNAL parameter is used to permanently assign a 
value to the SYCOM pseudo-signal character. The first non~blank 
character encounterec after the farameter is taken as_ the 
pseudo~signal character. (The default is *.".) 


Syntax: DEFAULTPSEUCOSIGNAL =-""~ <character> --~--------] 


END Paraseter 


Entering an END in the parameter string terminates the parameter 
input process. 


Syntax: <sycom job #> AX <parameter string> END 
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GROUPSIZE 


The GROUPSIZE parameter is used to cortrot the number of files 
that will be sent at one time wher sending entire families of 
files. The SYCOM program will transmit a nueber of files. equat 
to the groupsize and then check to see if another user has files 
to te sent and» if so» wilt transwit a nuaber of files for the 
second user equal to the groupsize» before continuing with the 
secord and subsequent groupse (CThe cefault is 9.) 


INBUFFERS 


The INBUFFERS parameter ‘conteots the number. of buf fers that are 
assigned to the fite “IN" at 80J. The file "IN" is used for 
input when doing file transfer and increasing the number of 
buffers can epees up the file transfer process. (The default is 
(32) 


Syntax? INBUFFERS = <integer> 


NOFS Paraneter 


SYCOM will not send a "“FS1" or “"FS2" Cfile separator) to the 
other system when sending card imaces Crelevant to RJE). (The 
default is fatse.) 


Syntax: NOFS 


MNOFTP Paraseter 


This parameter inhibits File Transfers if either system has this 
parameter specified. The purpose is clear» when specified» “no* 
Fite Iransfers are to occur for this system. There is no quick 
way to overcome this user restricticn. The only recourse is to 
shuttdown SYCOMs remove the Parameters file and correctly enter 
the desired parameters. CThe default is false.) 


 Syntaxs NOFTP 


NOPROGRAM 


The NOPROGRAM parameter inhibits fprogramto~SYCOM functions. 
CThe cefault is false.) 


Syntax: NOPROGRAM 
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NOTRACE 


The ANCTRACE qaraweter inhibits tracirg at beginning~ of~job. (The 
default is true.) 


Syntax? NOTRACE 


NOWAIT 


The NOWAIT parameter allows SYCOQF to go to end-of-job when it 
receives a disconnect messagee (CTthe default is true.) 


Syntax: NQOWAIT 


OQUTBUFFERS 


The GUTBUFFERS parameter controls the number of buffers that are 
assigned to the file “QUT” at BQJ. The file "OUT" is used for 
output when daing file transfer and inereasing the number of 


buffers can speed up the file transfer process. (The default is 
2.) 


Syntax? CQGUTBUFFERS = <integer> 


PROGRAM Parameter 


This farameter is specified when SYCOM is to perform programg-to- 
SYCOM functions. The “record size” parameter Limits the maxiaun 
length of these messacese (The default is true) 


Syntax: PROGRA™M 


QUEUESIZE Paraseter 


This parameter is used to establish the initial QUEVESIZE default 
value<« The value is changeable at any time during SYCOH 
operation via the "QS" command. The sinimuga value which can be 
specified is "4" and the maximum is *15". (CThe default is 8.) 


Syntax? QUEUESIZE = <value> 
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SYSTEKIO Paraseter 


This parameter is used to specify the name of the User Systeme A 
systemscid can te coeprised of frc# one to seventeen characters. 


Syntax: SYSTEMID = <system-id> Ceege» USERI) 


If the SYSTEMIC is not specified the MCP HOSTNAME will be used. 


TIMEOUTS Paraseter 


. This parameter establishes an “interval” for the assumption. that 
the remote system has gone “offlire™. A vatue of "0" inhibits 
this function. (CThe default is 11.) 


Syntax: TIMEQUTS = <mugber > 


TRACE Paranseter 


The usefulness of this parameter is to specify “disk tracing” at 
SYCOM initialization.j The default is no tracing initiated. | 


Syntax: TRACE 


TRACEAREAS 


This. parameter is also specified in conjunction with "TRACE". It 
is used to specify the “*nugsber of areas* for the disk trace file. 
The default value is "20". 


Syntax: TRACEAREAS = <value> 


‘TRACEBA Parameter 

This parameter is also specified in conjunction with "TRACE*. It 
is used to specify the “blocks ner area” for the disk trace file. 
The default value is "10". 


Syntax: TRACEBA = <value> 
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 TRACERB Parameter — 

This parameter is specified in conjurction with “*TRACE™. It is 
used to specify the “records per block" for the disk trace file. 
The default value is “4%. . 


Syntax: TRACERB = <vatue> 


WAIT Parameter 

This parameter is used to prevent SYCOM from going to “"end-aof~job 
when it receives a “disconnect messace“e SYCOM will disconnect 
and léerpse into a “offline/idle”™ state. (CThe default is false.) 


Syntax: WALT 
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The following is a Listing of a saaple NEWPARAMS file. 


ne ne 


NNN NNN 


we ae 


2 


This file "<sycom>/NEWPARAMS® can be used at BOJ instead of 
eneering parameters from the SPQ. 


If the file "<sycom>/PARANETERS® is not present at 80J 
THEN sycaow looks for a card file “<sycow>/PARAMETERS". 


If this card file is present then it wilt be used to create the . 
new "<sycom>/PARAMETERS” file. If» howevers the card file is not 
present them. sycom will look for a simifarty~nanmed disk file. 


Onty if neither card nor disk file is presents then SYCOM will 
request operator input for the new parameters. Note the use of “% 
@s a comment delimiter. Also fcr 10.0 more than one ACCEPT is 
allowed» enabting any nusber of parameters to be entered. The new 
parameter "END" wilt terminate the ACCEPTing of any further 
farameterse ; 


Fecomsenced parameters for SYCOM on USER? 


special characters NOT allowed 

IF this parameter is not specified 
THEN the HOSTNAME from the MCP will 
te usede The "09" stationid message 
will be sent to the remote systen 

in any casee 


systemid = ~ slave7 


NNN HM MN 


for SLAVE/BACKUP. A file <sycom>/0UTQ 
will ce opened INPUT for reading input 
from @ program such as SLAVE/BACKUP. 

If this parameter is not specified THEN 
progré# input can be enabled by use of 
new PROGRAM cogmand. 
default = FALSE- added for completeness 


progras 


MMH N NM 


noprogram 


buffer = 1950 2 @axigua = FILE_TRANSFER_MAX_BUFFER 
which is a compile time constraint 
and which could/might be returned 
tc dynamic serory instead of static 
MERCY» je@e the way it was done 
before the iaplementation of NDL i/o. 
This parameters determines the maxinaua 
size cf the SENDING record. 
The size of the receiving buffer is 
a compile time C€ onty J] variable € 1950 ) 
It may now be dynamically 
changed at run time by use of the 
“.BUFFER™ command. If no new value is 
giver it will display the current value. 
The run time changing of the TRANSMISSION 
SUFFER size will NOT affect the 


Pe MEM ARN NM MM N 
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Z <syco#>/PARAMETERS on diske 


queuesize = & % this is the default values Maximum is 15 
% QUEUESTZE € MAX_MESSAGES in SYCOM ) 
% contrcis the number of messages written 
% to the LINK file. Its dependent variable 
2 MARKER_OFFSET» for determining when the 
% “GOOD_LRESULTS” mechanism is invoked» is 
% © MAX_MESSAGES / 2) +41 
% The cueuesize Way be queried or enanaed 
2 run time by using the ™.QS" command. 
2 Any rew value will not be saved in the 
% <sycose>/PARAMETERS file on disk. 
timeouts = 11 42 this is the default vatue. If this nuasber 
% of consecutive timeouts occur then the 
2 rercte system is considered OFFLINE. 
trace % this is the default for OISK tracing. 
2 notrace 2 default = FALSE 
tracerb = 4 2 default = 4 records per block 
% 4 x 132 = 528 
Z 540 = 180 « 3 
tracerb = 8 2 8 records per block = 1056 
% 6 sectors at 180 bytes = 1080 bytes 
traceca = 10 42 default = 10 blocks per area 
traceareas = 20 % default = 20 areas 
X 4 * 1C€ * 20 = 800 records in DISK.TRACE 
z wait % default = FALSE 
nowait % default = TRUE 
Z debug % default = FALSE 
y 4 noftr % default = FALSE» is e- file transfer is allowed 
2 nofs % defautt = FALSE» i. e- file separators are sent. 


% This parameters is used in conjunction with 
Z HOST/RJE C 8170C/B1800 ) which currently will not 
% accept file separators. 


this is the default € "." ) 
may be set to any non blank character 


defaultpseudosignal . 


nr x 


this is the default € = 99/10 ) and is 
number of files sent in group with in a 
family of files being transferred. 

Ne-B. 99 is the size of the PUT QUEUE file 
If this parameter is set to 1 only one 
family sember will be sent with checking 

for any other file transfer requestse 
If» honever» it is set to the maxigun 

value cf 99 then no other file transfer 
requests will be honoured until the 

whole fagilty has been transferred. 


groupsize = 9 
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This is the default vatue. It can be set 
to any other value and is the number of 


buffers atlocated to the file <sycom>/IN 


This is the default value. It can be set 
to any cther value for the number of 
buffers allocated to the file <sycom)/0UT 


This is a required parameter if the 
Paraweters are being entered froa the ODT 
It is the last parameter and is entered 
to ter®inate the tist of parameters. 

It optional if the parameters are being 
read from the <sycom>/NEWPARAMS file. 


Ns Bs The following parameters can have their value changed at run 
time by the SYCOM command follconing the parameter:- 


Any SYCQMF station can interrogéte the value of any of the above 
parameters at run time with any cf the above SYCOM commandse Only 
stations declared as ODT (€ or CHANGE'd by the SMCS ) can alter any 

The altered value is valid until the next alteration 
At next SYCOM AOJ the values wilt revert to their 
previously declared values caortained in the <sycom>/PARAMETERS file 
Te permanently change the values in the <sycom>/PARAMETERS file it 


inbuffers = 3 
outbuffers = 2 
end 
Zz 
Z 
4 tuf fer buffer 
z debug debug 
Z groupsize groupsize 
z crogram progras 
r4 roprograam pregraam 
z cueuesize qs 
Zz systemid systemid 
4 trace trace 
y 4 notrace trace 
z wait ..- wait 
z nowait wait 
Zz 
4 
z 
2% of the values. 
Z% or SYCOM ECJ. 
z 
Zz 
Z% must be rewoved and re-created. 
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% @e ge 2* . . _ interrecgation reply from SYCOM: 

z *e sycom ebuffer 7 

z : RUN TIPE TRANSMISSION BUFFER SIZE 15 1950» RJE SIZE = 400 

Zz *p syconm edebug 

% DEBUG CFF 

z *D sycom egroupsize 

% GROUP SIZE IS 9 

y 4 xp sycom eprogram 

% PROGRA® INPUT ENABLED 

z p sycom eqs: . 

P 4 QUEUE SIZE/OFFSET = 473 

4 *p sycom esystemid 

yA SYSTEM ID = “SLAVES " 

v4 #0 Sycom etrace 

y 4 TRACE CN 4 * 10 * 20 = 800 RECORDS 

4 *D SyYCOM enwait . 

Z WAIT OFF 


f= 1 
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SYCOM Coga@ands fecs the ODT 


The system operator is permitted to communicate with SYCOM using 
the MCP "AX" facility. By entering certain coamands Cexamples 
below)» the operator is also permitted to communicate with 
application prograras ina Server Systems thru the “virtual 
terminal" facility of SYCOM. A typical command session might go 
as follows? CDOT input is flagged with *"">" and indented tLines 
are output reply messages: _ 


““> <sycom jot #> AXsWHAT<etx> 


SYCCw IX.-0-2 €3C JUL 79 14253) ONLINE? 2 FILES QUEUED; 
SENCINGS CJH)/#665 €7901/15325)7 

THIS STATION NOT CONNECTED 

LOCAL HOST = USERIs» REMOTE HOST = SERVER1 


"=> <sycom job #> AX.US MY/USER<etx> 


B170C/B1800 SYCOM IX.9-2 CIC JUL 79 14253). | 
USER MY LOGGED ON TO SYCOW AT 1123122223 ON 22 AUG 79 


“-> <sycom job #> AX.FETCH *DM¥PALL <etx> 


FILE DMPALL START TRANSMISSION 
FILE "DMPALL™ START RECEPTION 
FILE “OMPALL™ RECEIVED 
FILE DMPALL END TRANSMISSICN 


“-> <sycom jot #> AXsPUT CMY)/#3152 CNO LIST)<etx> 


FILE CMY)/#3152 START TRANSMISSION 
FILE "U/CMY)/DMPALL™ START SENDING 
FILE (MY) /#3152 END TRANSMISSION 
FILE "U/CMYI/DMPALL™ SENT 


-“-> <sycom job #> AX-CONNECT<etx> 


CONNECT INITIATED £0281] Aa aA 
CONNECT COMPLETED 


Bi8CC/B1700 SMCS MARK IX.0.C0D €08/20/79 13:40) 
CMY) LOGGED ON ~SMCS—- AT 09236 0OQ8/22/79 

YOU ARE AT STATION 13 CVIRIUALY 

News: This is Serverl SMCS» say I be of hetp? 


“-> <sycom job #> AX .WHAT<etx> 
SYCCM IX.0.-2 (30 JUL 79 14253) ONLINE? 2 FILES QUEUED> 


SENCING: CJHI/#665 €7901/15325)5 
THIS STATION CONNECTED (£0281) Aa aA 
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USERCODE= MY» LOCAL HOST= CUSERIs REMOTE HOST= SERVER 
eae <sycoe job #> AXZ COPY DMPALL AS ADMP><etx> 
“SYSTEM/COPY =eiab #> BO0J- PP=9»9 MP=9 TIME = 09238:54.3 
"COPY 909" REMOVED 
"DMP ALL” COPIED FROM SYSTE®P DISK TO SYSTEM DISK AS ADMP 
SYSTEM/CUPY =<job #> 1 FILE COPIED 
SYSTEM/COPY =<job #> ENS. TIME = C9241233.6 
“-> <sycom job #> AX.DISCOUNNECT<etx> 
‘STATION DISCONNECTED 
=> <sycom job #> AX.FETCH ADMP<etx> 
FILE ADMP START TRANSMISSICN 
oFILE "U/CHY)ZADKMP™ START RECEPTION 
“FILE “U/CMY)/ADMP™ RECEIVED 
FILE ADMP END TRANSMISSION 
“--> <sycom job #> AX.~8YE<etx> 


CMY) LOGGED OFF SYCOM AT 05:56:11.8 ON 22 AUG 79 


— 2 = om as weueeaaawa enemenweteososzeoeoe sf, {J fJrsseasssceees te ee ee ek oe 


SYCO™M HRUckAN SHUTDOWN 


when SYCOM is running as a sel f~sustaining entity (without the 
SMCS)> the *.—£0J" command orovides the means by which an orderly 


sShutdcwn can occur. Once this ccamand has been entered» alt 
subsequent commands entered are rejected. An appropriate “close 
messace“ is sent to the other SYCOM after the completion ot ait 
inwprocess file transferse SYCOM then sends a “disconnect 


message” to the Network Controller ard goes to “*end-of-job”.- To 
initiate an orderly shutdown of SYCOM>» the system operator aust 
enter the following: 


“-> <sycom job #> AX.EOJ<etx> 
The following message is displayed ismediately on the User ODT: 

2 SYCOM =<job #> “EQJ" IN PRCGRESS- PLEASE SIGN OFF 
No further processing reauests are accepted. Any file transfers 
queued to process are allowed to cosglete. At the point in time 
when there is no longer any SYCOM activity and att users 
Cinctuding possible program input) are disccnrected» SYCOM goes 
to “EQJ". The stancard MCP "“E0OJ message” is disolayed for this 


actions: 


SYCOM =<job #> EQJe TIME = 1622125501 
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when SYCOM is running in a self-sustzining environment and it is 
necessary to shutdown the system “imwediatety"» then the *.STOP®” 
command provices this means for termiratton. Upon entry of this 
commands ait in-process activity is aborted. A “close message" 
is then sent to the other SYCOMs cnly if switched Line» a 
“disccnnect message” sent to the Network Controtlers and the 
progrem goes to “end~of-job". The system operator enters the 
following to initiate the immediate shutdown cf SYCOM: 


oe 


“-> <sycom job #> AX.STOP<etx> 
The fcllowing wessages are then displayed or the system ODT: 


2 SYCOM =<job #> *STOP™ IN PROGRESS 
SYCOM =<job 4> ECJ- TIME = 16221:55.1 


When SYCCM is running in conjuncticr with the SMCS» the "STOP" 
command entered to the SMCS in turn causes SYCO™ to be terminated 
automatically. When this occurs» the following message will be 
displayed on the ODT: 


SYCOM =<job @> DEATH IN FAMI 


LY. TIME 16221:55.1 
- A note of importance: If there are any requests queued for 
processing»e they are retained 1f SYCOM shuts down under these 


circuestances. 


PRINTING THE TRACE FILE 


The disk TRACE file can be printed with the “*.LIST™ command. 


REACTIGNARY HINTS ANC POINTERS 


During the course of SYCO™M operations» there are a few unusual 
systew# “conditions” which could cccure In crder for the system 
operetor to correctly respond to these conditions» there must be 
sufficient information available. That infcrmation is provided 
here in the form of problem descriptions» “hints”>» "“pointers”» 
and responses to these conditionse 


A. khen SYCOM appears to be *hung-up"» enter "<job #>WY" at the 
system OCT. If the following sessage is displayed: 


SYCOM =<job #> WAITING MAGAETIC TAPE <tape label> 
then SYCC* has been automatically stopped waiting for the 


required a@agnetic tape to becose available, at which time 
SYCOM operations will automatically resume. 
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Tnis condition is resclved by the operator making a scratch 
fagnetic tape available to the system. 


Should the following message be cisplayed: 
SMCS =<job #@> WAITING QUEUE NOT FULL FOR WRITE 


then SYCOM has been automatically stopped from “writing” any 


‘more messages into the Network Controller's input queue 


until it can successtully deliver at least one output 
@essagee . * 


- If this conditicn does not resolve itself after sone period 


cf time (2 - S minutes)» the syste@ must be brought down 


with the wCpPp "QC" command. CA system inctudes the SMCS» 


Network Controller» CANDE» and any other program associated 
witn the Network Controller.) : 


Cr if the following wressage is cisplayeds after SYCOM has 
teen just. executed: 


SYCOM =<job #> EXECUTING 


Then the problem lies in the fact SYCOM is attempting to 


establish a line connection tc ~@ remote system. It. wilt 


continue in this cycle until either the connection has been 
established or the program DS*"d. No input commands are 
entertained durirg this initial establishment cycle. 


If SYCO™¥ appears to be “stuck™ during a file transfer» and 


the remote system is still “cnline™> then either the 
“ONLINE* or “RESTART” commands aay be tried. 


1) The “ONLINE” command will break the connectton and 
atteapt to reestablish remote connections. | If 


successful» SYCOM will autoratically start sending the 
aborted file again. Le 


2) The "RESTART™ command» with no operand» witt cause the 
same procedure tc te inveked»s except that the current 
PUT GUEUE will be thrown anaye If however» an operands 
either an implicit or relative schedule number is 
entered» then the systesr will start transmission of the 
specified file after evaluating the scheduie number. 


If the following wsessage is cisplayed (hy the MCP) on the 
system ODT during the initialization phase: : 


INSUFFICIENT DISK WHILE OPENING QUEUE-FILE "SYCOM" 


It means that there is not sufficient space on disk to open 
the “SYCCMJLINKIC™ queue. Affirmative action by the system 
operator would be to make available a sufficient amount of 
cisk space Capproximately 20C0O segments). 
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TERMINAL PROCEDURES 


In this sub-section» basic ter@iral operating procedures are 
provided in the fors cf exasples. For a SYCOM oriented system 
however» terminalis may be owned by either SYCOM or the SMCS. 
Because of these possibilities and the assactated jianlicationse 
specific operating procedures are inctuded for both *"SYCOM 
controlled” anc “SMCS controtled™ terminals. 


TERMINAL FUNCTIONS 


Terminal functions are those software features found in a 1T1D820> 
and/or 10830 type Video Disrlay Terainat CV¥0OT) devices. These 
terrmiral features woutd included such things. as» tab stops» 
fower/upper cases scrolling» etces These functions are fully 
described in the Supervisory Message Control System (SMCS) 
Software Cperational Guide Csee docurentation reference). 


TERMINAL OPERATIONS CSYCOM CONTROLLETL) 


When a tocal terminal is under the direct control of SYCOMs» it is 
alse permanently “attached™ to ite Therefore» aterminal user 
has igmediate access to SYCOM functicrse A terminal can however» 
be tegporarily “attached™ to either SYCOM or the SMCS in a Server 
Systeme Thru Server System"s SMCS» the terminal can also he- 
"attached™ to an appropriate interactive application progran in 
the Server System. The terminal user is not Limited to just a 
few S*CS commands» a user may invoke any coamand which the SMCS 


has in its repertoires with the excertion of those restricted to 
input from the ODT. ; 


Example Interective Terminal Session 


Termirals at this point are attached to the User Systea's SYCOM. 
In order to utilize the SYCOM capabilities» a terminal user need 
only enter the desired SYCOM cocfasands. Awuong these SYCOM 
commands are “.eCONNECT™ and *.DISCONNECT™. These are used to 
gain gccess to any appropriate interéctive application program in 
the Server System. The exaaples which foilow exptore alt 
possitle terginal connections as detailed in “Message Path 
Assignments”. 


In the examples below» terminal input is identified by the flag 


Me > Ms All cther lines are reply wessages from the program to 
which the tergsinal is currently inputting toe First some basic 
Local SYCOM commands @2re shown. Alt SYCOM commands are entered 


directly as exampled below: 


“=> .WHAT (User SYCOM) 


7-6 
BURROLGHS CORPCRATION COMPANY CONFIDENTIAL 


COMPLIER SYSTEMS GROUP . 61800/81700 SYCOM 
SANTA BARBARA PLANT . Pe Se 2219 04586 CA) 


~SYCOM I[X.-Ce.2 (30 JUL 79 14253) ONLINE; IDLE 
THIS STATION NOT CONNECTED . 
LECAL HOST = USER1» REMOTE HOST = SERVER 


--> PUT DHPALL (User SYCOM) 
FILE OMPALL START TRANSHISSION | 
“=> GWHAT : | (User SYCOM) 


SYCOM IX.0.2 (30 JUL 79 14253) ONLINE? 

O FILES QUEUED? SENDING CMPALL (477/85) 
TEIS STATIGN NOT CONNECTEC | 
LCCAL. HOST = USER» REMOTE HOST = SERVERI 
FILE OMPALL END TRANSMISSION 


==>) .CUNNECT | | (User SYCOM) 


CONNECT INITIATED £0291 Bt bB 
CCNNECT COMPLETED to HOST = <hostname> 


--> WHAT _ ? (User SYCOM) 


SYCOM IXe0e2 C30 JUL 79 14253) ONLINES IDLE 
THIS STATION CONNECTED £629) Bb bB 
LCCAL HOST = USER1> REMOTE HOST = SERVERI 


“-> MLE¥X _ (Server SMCs) 


MIX LIMIT=63 
SERVER/NC =<job #> PP=15» MP=15 
SMCS =<job #> PP=13» MP=14 

— SERVER/SYCOM =<job #> PP=12» MP=12 
RD =<job #> PP=11» MP=11 
ENC MX 


It is necessary that the terminal cuser be aware of what “signal 
character" the Server Systea's SMCS is currently using. To find 
out» the following comgmanc is enterec to query that character: 


--> SIGNAL a 7 (Server SMCS) 
CURRENT SIGNAL CHARACTER = $. 


Now the terminal user can “sign on™ tc an application program in 
the server System», and alternately enter cowmands to the Server 
Systes’s SMCS. A series of followinc interactions exemplify this 
concept: CThe application program “SET/TABS" used in the example 
1s assumed to “set™ specified tab stcps in the user's terminal.) 


--> SIGN ON SET/TABS (Server SMCS) 


SIGNED ON TO “SET/TABS"> SIGNAL = $ 
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"> $MLIMX . (Server SMCS) 


MIX LIMIT=63 

SERVER/NC =<job #> PP=15» MP=15 
S*CS =<job #> PP=13» MP=13 
SERVER/SYCOM =<job #> PP=12» MP=12 
SET/TABS =<job #@> PP=12» MP=12 

RO =<job #> PP=11.» “MP=11 

ENC MX 


==> 10920930 24050960970 > (Server AP) 


(tab stops are now set) 
REMOTE FILE CLOSED BY “SET/TABS". 


--> EX CMPALL#FI OUTP.FILE INV 2 - C@Server SMCs) 
DWPALL =<job #> BOJ. PP=S» MP=9 TIME = 11:35:21.8 
Z DMPALL =<jok #> ENTER SPECS . 
DMPALL =<job #> ACCEPT. 
--> <dmerall job #> AX COPY DSKLST SMCS/TRACE 
DMPALL =<job #> “oUurPUT" = *“BACKUP.~PRT/906* 
OMPALL =<job #> “"BACKUP.PRT/906" RELEASED © 
% OMPALL =<job #> ENTER SPECS 
DMPALL =<job #> ACCEPT. 
“-> <dmpaitl job #> AX 
DM¥PALL =<job #> EQJ. TIVE = 11236:°58.1 
At the point in time when a user is finished entering commands to 
SYCOM and wishes to terminate the sessions the following command 
is entereds however» the terminal is still "attached" to SYCOM. 
--> .DISCONNECT — _ | (User SYCOM) 
STATION OYSCONNECTED 


seeneencs- caiaeiatetataeatatedenaenetatatebanel AAA A fatatatateteratenataatatatatatatatatrtatataatatatatatatel 
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Terminal Qperations (SMCS Controitited) : 


When a terminal is permanently attached to» and owned by» the 
SMCS» the terminal user must gain access to SYCOM functions thru 
the use of explicit SMCS commands. These commands are exaapled 
below. By gaining access to SYCOM» the SMCS will temporarily 


. “attach" the requesting terminal tc SYCOM for the duration of a 


session. However» a terminal user is not Liwited to just a few 
SMCS commands» a user may invoke any coamand which the SMCS has 
in its repertoires with the exception of those restricted to 


input from.the ODOT. 


Example 1: Interactive Session 


The terminal at this point is attached to the User System's SMCS. 


In order to gain access te those rifty SYCOM capabilities» the 
terairal user must make use of the SMCS “SIGN ON* and “SIGN OFF" 
commands. The sample session which follows» shows the terminal — 


user just -how easy it is to “get on" and “get off™ SYCOM: Cinput 
from the terminal is identified by the flag *-7>*.) 


--> SIGN ON SYCOM (User SNCS) 
SIGNED CN TN "SYCOM"» SIGNAL = *& 
When the "signed-on™ message is returred to the terminals that 


tersiral is then attached to SYCOM. Therefore» SYCO™M commands 
are ertered directly as exaspted betcu: 


“-> WHAT CUser SYCOM) 


_SYCOM IX.0.2 €30 JUL 79 14253) ONLINEs IDLE 
THIS STATION NOT CUNNECTED 


LOCAL HOST = USER1» REMOTE HOST = SERVER! 
--> .PUT DMPALL | | (User SYCOM) 
FILE DMPALL START TRANSMISSION 


<-> WHAT | | (User SYCOM) 


SYCOM IX.0.2 €30 JUL 79 14253) ONLINES 

OQ FILES QUEUEDs SENDING ECPMPALL €47/85) 
TRIS STATION NOT CONNECTED 

LCCAL HOST = USER1» REMOTE HOST = SERVERI 
FILE DMPALL END TRANSMISSION 


-“--> .eCONNECT CUser SYCOM) 


CONNECT INITIATED £0281 fa aa 
< 


CONNECT COMPLETED to FOST = <hostname> 


j 7-9 
BURRCLUGHS CORPCRATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP | B1800/81700 SYCON 
SANTA BARBARA PLANT Pe S. 2219 0458 CA) 


==> WHAT . CUser SYCOM) 


SYCOM IX.0.2 C30 JUL 75 143535 GNLINES IDLE 
THIS STATION CONNECTED £€C28) Aa aA 
LCCAL HOST = USERI» REMOTE HOST = SERVER 


“-> #REPCRT > (User SMCS) 


>R1 -CODT): OK JOB #15 SYCOM. 
1 STATION REPORTED AT 113242 08/22/79 


-=-> MELsMX CServer SMCS) 


MIX LIMIT=63 

SERVER/NC =<job #> PP=15» MP=15 
S¥CS =<jok #> PP=13»5 MP=14 
SERVER/SYCOM =<job #> PP=12» MP=12 
RO =<job #> PP=11» MP=11 

END MX 


It is necessary that the SMCS in a Server System have a “signal 
character” thet is different than that of the SMCS in the User 


Systese- To ensure thiss the fotlosing comand is entered to 


query that signal character: CIf it "is not” different» then 
change its "SIGNAL $*".) . 


“=> SIGNAL : CServer SMCS) 
CURRENT SIGNAL CHARACTER = $ 


Now the termiral user can “sign or™ toa an application program in 
the Server System> and alternately enter commands to the Server 
System's SMCS. A series of following interactions exemplify this 
cencerpt: CThe application prograr “SET/TABS"™ used in the example 
is assumed to “set™ specified tab stops in the user's terminal.) 


--> SIGN ON SET/TABS CServer SMCS) 
SIGNED ON TO *SET/TABS"» SIGNAL = $ 
==> $ML>3MX (Server SMCS) 


MIX LIMIT=63 

SERVER/NC =<job #> PP=15» wP=15 
SMCS =<job #> PP=13» MP=13 
SERVER/SYCOM =<jfob #> PP=12» MP=12 
RC =<job 4> PP=ils MP=11 

SET/TABS =<job #> PP=4» MP=4 


END MX 
2=> &*REPORT > (User SMCS) 
>R1 CODT): ON JOB #15 SYCOM 


1 STATION REPORTED AT 11244 08/22/79 
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==> 1002003C24C 2502600790 (Server AP) 


Ctab stops are now set) 
REMOTE FILE CLOSED BY “SET/TABS". 


--> .sDEBUG | i (User SYCOM) 


DEBUG OFF 
--> .DISCONNECT ~ 7 (User SYCOM 


STATIGN DISCONNECTED 


At the point in time when a user is finished entering commands to 
SYCOM and wishes to terminate the sessions the following command 
is entered: (This is a SMCS command.) 


o77> #SIGN OFF 0 , (User SMCS) 
The response from the SMCS will be as fottows: 
| SIGNED OFF “SYCOM™ 


At this point» the terminal has been “detached” from SYCOM and is 
now “re~attached”™ to the SMCS. 


Exaucle 2: Irteractive Session» Systes Strings 


This exaaple of a typical interactive session whereby the user on 
one systew cosm#unicates through several other systems in a string 
of systems to direct the eng system ir specific functions. To do 
this» example 2 utilizes the SMCS “PASS" command exclusively. I[t 
provides the means to establish ccrmunication Links to an end 
syste® without having to “sign-on” tc each system in the link. 


At this point the terminal is attached to the User System's SMCS. 
In order to gein access to the SYCOM system~string capabilities» 
the terminal user can either make use of the SMES's “SIGN ON" and 
“SIGN OFF" commands or the “PASS” ccawande For this exaaples the 
PASS cowmand will be utilized. 


For this example of accessing systeua strings» the distributed 
systes complex we all know as the HUB/Stave systems was chosen. 
Therefore» each step of the following procedure can be compared 
against the string System schematic or the following page. With 
this combination» a user carn go as far into the system=strings as 
desired. | 


In the following orocedure» exangple terminal input is shown in 


"lower case"s upper or lower case is allowable. Terminal tnput 
?s aiso flaggec with the "--->" reference identifier. 
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Multiple System Message Path Schematic 
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we will tegin ty logging~on to the user*s SMCS. This establishes 
a base connections howevers it is not a requirement. 


“=> id “sycom user" a alaietetetatebetatatatatetetatetatatetateret > CSMCS>s sys 1) 


B1800/B1700 SMCS MARK IX.0.00D (08/20/79 13240) 


“sycor user™ LOGGED ON ~S¥CS—- AT 08246 08/30/79 
YCU ARE AT STATION 1 CT£LEA22) 


If “US A/B™ is ertered then user A with password 8 is logged on 
to the local SMCS- ALL subseauent PASSes to SYCOM witl 
- automatically inctude this usercode/password pair. Thus» if the 
- user is dectared to be a workstation» file security is enforced. 


When the “lLogged~an" message is returned to the terminals that 
'tereiral is then attached to the SMCS. Hereafter» SYCOM commands 
are ertered via a series of "PASS" #essages as follows: 


“=> op sycom econnect Sao SR 8 a now aoe > CSYCOMs sys 1) 


CONNECT INITIATED £028) fda ad 
CONNECT COMPLETED 


“=> p sycom eSignal LL: -sseees<<s<ese ese se<=>- CSYCOMs sys 19 


STATION SIGNAL IS "1" 


“=> p sycom Ilwhat -cec-------- taeda ----> CSYCOM3 sys 1) 


SYCOM IX.0-2 €30 JUL 79 14253) ONLINES 1 FILE QUEUEDSs 
SENDING: €7901/15325)3 | 

_ THIS STATION CONNECTED €028) Aa aA 

~ LOCAL HOST = SL2» REMOTE HOST = HUB 


One wilt not see filenames since it is a usercoded files» unless 
lcggeaq on the SMCS as usre (JH). (CSee above) . 


==>. 9 SyYCOR -systee 1d. “ss ese%% sees <-"4=-2 > CSMCSs% sys 2) 
SYSTEM-ID2 THE.HUB 


TT TIITITITLCLE LETT LELLECELT CECE CELL COCUCLLECCCCCLOCLCCCCC LEC 
Current terminal PASS message paths: 


I--"> p sycom 1<xx> «© « «© © © « 2 & SYCOM sys 1 
I-"-"> p SyYCOM <KX> «© «© « © © © «© » SMCS sys 2 
PLP EE Ee ed BE EE Be 8 Ee 8 EB EE BE hE 2 eo 2 8 BB 8 8 888 BE 256-2 8 8 OE ES BB RE Be oY 


bs | 

; | 

VOT input See eee > <xXxX> «© © © eo Pee 2 es e© ® e8® e@® 2 SMCS syS 1 
a 

bf 

| 
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""> p sycom mlymx. oem ern PA Reta nee ee > CSMCS* sys 2) 


MIX LIMIT=63 : 
HUB/NCeJUL26 =<job #> PP=15» MP=15 
SMCS =<job #> PP=13>» MP=14 | 
CUSERL)/SYCOM =<jobd #> PP=12» MP=12 
CUSER3)/SYCOM =<job #> PP=12» MP=12 
END Mx = | | 


At this point» as shown in the messace path block above» the user 
has established a communication Link to a second system. Input 
can be sent the SMCS» MCP» or SYCCM in either of the two systems. 


if a connection is desired to a thire systets then continue With 
be entering the following command: 


"“"> p sycom p user3 econnect cessttttts<"- > CSYCOMS sys 2) 


CONNECT INITIATED €0311] fa aa 
CONNECT COMPLETED to FOST = <hostrame> 


==> p sycoe 9 user3 esignal 2 sse3eeersnen > CSYCOMs sys 23 
STATION SIGNAL IS "2° 

“<> (p SyCcOm p-wsers Cuhat ““"SsSessses3se5= > CSYCOMs sys 2) 
CUSERZI/SYCOM IX.90.3 €C& ALG 79 15219) ONLINEs IDLE. 
THIS STATION CONNECTED £021] Aa aA 
LOCAL HOST = HUB» REMOTE HOST = SLAVES 

“-> p sycom p user3 system cwrcrtt" = Sess 5=* > CSMCS? sys 3) 
SYSTEM-ID: SLAVE3 


SYSTEM@TRANSLATE: ON 7 
SYSTEM-VERSIONS 81800/21700 SMCS MARK IX.0.09D 


OE BO BB eG Oe CE 8 BBB BBR EBB hee Be Be ae eB ee BE ee BR BEE eo 6 EB ee ee BE eee Re 


m1 Current terminal PASS message faths: rs 
bY Le | 
mw VDT input “77-477 > <xx> 2 2 © 0 © 2 ew ew ee ew | «6USMCS Sys 1 8 
mm Im---> p sycom L<xx> .« « «© «© e« « @« « SYCOM sys 1 & 
n I-"--> p Sy¥YCOM <xXx> ec « © © e« © @« «© SMCS sys 228 
m I---> p sycom p user3 Z2<xx> « « « » SYCOM sys 2 & 
nt j---> p sycoa@ p user3 <xxXx> 2s e @ « SMCS sys 3 8 
OP Oe Been Oe eee ee a 8 Oe Be Ee ERE eee ES BREE Teo a Oe ee ee eee BY 


The user how has access» via SYCOM cecnnections» to a third system 
in the string of systemss as pictured in the message path block 
abovee If it is desirable to extend these connections to a forth 
system» then enter the following coagand string: 


7~14 


BURROUGHS CORPCRATION . COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP . ~ B18600/781700 SYCOM 
SANTA BARBARA PLANT Pe Se 2219 0458 CA) 


--> p sycom Pp user3 p sal -conrect “""""""> CSYCOM? sys 3) 


CONNECT INITIATED £036] &#@a aa 
CONNECT COMPLETED to HOST = <hostname> 


*7> p sycom p user3 p sal esigral 5... \Sresee > CSYCOMs sys 3) 
STATION SIGNAL IS ™3*° 

ce ? sycom p user3 p sal Swhat ‘aeansueoss CSYCOM; sys 3) 
SAY IX.-0.3 €08 AUG 79 15319) ONLINEs IDLE. 


THIS STATION CONNECTED €0361 Aa aA 
LOCAL HOST = SLAVES» REMCTE HOST = SAI 


POPPE ee eee eee ee ree eee ee eee ee ee ee ee ee ee ee Se ee | 


a Current terminal PASS message paths: au 
a : a n 
a VCT input wcrc: "> <“MX> 2 2 © © © © © © 6 2 2 oe SMCS SYS 1 & 
a I---> p sycom 1<xx> «2 «© « © © © © = SYCOM sys 1 a 
a jr7-7> p syCcon “xX? e e8« e #© @® ® @ @ SMCS. sys on 
a im---> p sycom p user3 2<xx> . « « « SYCOM sys 2 a8 
w i-"-"-> p sycom p user3S <xx> « « « « SMCS sys 3 8 
n i---> p sycos p user3 ¢ sal 3<xx> . SYCOM sys 38 
- I---> p sycom p user3 ¢ sal <xx> «.« SMCS sys 4a 
Lf 


EE SE UE Bs OS US ES Be ES Ee TE EA BP OE EL TE Ce Td BE G2 EN SN TE BS SE OS ee EOE re NS re BS ES Bl GF Ue BE CES Fd Ye OL Fe TE OE BS TE EE BL EY 3a ES EA SE BE TSE UE ne re Ee 


At this point» the user has connections all the way thru to the 
SMCS in system "SAI. Commands car te giver to the SMCS or MCP 
in that system or any system along the way in the message path 


s connectionse 


--> p sycom Pp user3 p Sal systesw <“o3soc-ce-- > CSMCSs sys 4) 


SYSTEM~1D= SAl1 
SYSTEM*TRANSLATES ON 
SYSTEP“VERSIONS BL600/B1700 SMCS MARK IX.0.00D 


--> p sycom p user3 p sal wmlsax cote s""-=> CSMCS3 sys 4) 


MIX LIMIT=63 

SAL/NC =<job #> PP=15» MP=15 

S¥CS =<job #> PP-1l45 MP=14 
CUSER3)/SYCOM =<job #> PP=13» MP=13 
CANDE =<job #> PP=13» MP=13 

RO =<job #> PP=13» MP=13 

END MX 


terminal user can 
tems and/or issue 


.iw se ws sw ww Mw 


With the current inter~system connectionss a 
“signeon™ to frograms in either of tte four sys 
SMCS and MCP commands in those systess. 


P=15 
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In the following example» a compile is initiated in the forth 
systems without usercode security heing enforced: 


“"> p sycom p user3 p sal co ¢x sdisfi cards nam xs dsk3 


PX =<job #> BOJ. PP=4» MP=4 TIME = 09:00:20.6 
PX =<job #> EQJ. TIME = €9202208.8 


After ali transactions with the SAl system have been completed» 
att connects must be “discannected". This must be accomplished 
with the fotlLowing command procedure: (By giving a “bye*™ command 
tc each SYCOMs the “station signal character" is restored to "." 
and the virtual station is autotaticatly "disconnected". ) . 


--> p sycom p user3 p sal Sbhye cette terrer= > CSYCOM$ sys 3) 


STATION DISCONNECTED 
USER SY LOGGED OFF TO SA1 AT 09:01221.3 ON 30 AUG 79 


==> p sycom p user3 2bye “eer4et eae > CSYCOMs sys 2) 


STATION DISCONNECTED , 
USER SY LOGGED OFF TO CUSER3)/SYCOM AT 0920224421 GN 


--> p sycom ibye ------ o----- crecere--- ---> CSYCOM$ sys 1). 


STATION DISCONNECTED 
USER SY LOGGED OFF TO SYCOM AT C09:03238.1 ON 30 AUG Z 


“=> —P SYCOM What “cers sstSserer= eS ee ee se > CSYCOMs sys 1) 


SYCOM IX.0.2 €30 JUL 79 14253) ONLINE? IDLE 
THIS STATION NOT CONNECTED 
{CCAL HOST = SL2» REMOTE HOST = HUB 


At this point» control of the terminal has reverted to the SMCS. 


Example 3: Interactive aession»s Systes Strings 


This is other example of a typical irteractive session when the 
user on a local system communicates through several other systeas 
in a “string cf systems” to direct an “end system” to perform a 
series of specific furctionss of the user*s discretion. 


In this example» use of the SMCS “SIEN ON"W command is utilized to 
provide the means to establish the ccraunication links to an "end 
systew"> Signing=on" to each systee# in the Linke By doing thise 
aouser 18 assured that tasks can he cirected to “any” system in 
the string anc have the appropriate security applied as needed. 


At this point the terminal is attached to the User System's SMCS. 
In order to gain access to the SYCOM system-string capabilities» 
the terminal user will make use of the SMCS*s “SIGN ON” command. 
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For this exasple cf accessing systea~strings» the distributed 
system complex we all know as the HUG/Slave systems was chosene 
Therefore» each step of the foltowirg procedure can be compared 


against the string-system schematic (Figure V~1). With this 
combirations a user can qo as far into the system=strings as 


d es i re d rs ee be 

In the following procedures exaapte terminal input is shown in 
“lower case” Cupper or tower case is allowable). Terminal input 
is also flagged with the “-~->" reference identifier. 


Refer to Figure V-1 for the string system message path schematic. 


The user begins by "“Logging-on" to the local SMCS. This usercode 
and péssword will be used by both SYCOM and SMCS to automaticatly 
log the user on to each system in the Link CSYCOM/SMCS)°: 


--> us sy/user testttreeo-n- wemewrenecen==-> (SMCS sys 1) 


B1800/B1700 SMCS MARK IX-0.00D0 (08/20/79 13240) 
CSY) LOGGED ON -SMCS- AT 09213 08/30/79 
YCU ARE AT STATION 1 (10832) 


The terminal is still attached to the SMCS in system 1. To make 
an attachment to SYCOMs» enter the fallcwing “SIGN ON" command: 


“-> on sycon SaRare eerie eee e se Sessa Se—=> CSKCSs Sys. 1) 


 SIGNEC ON TO “SYCOM™s SIGKAL = * 
B1700/B818C0O SYCOM [X.-0.2 €30 JUL 79 14:53) 
USER SY LOGGED ON TO SYCOM AT 09213:38.1 ON 30 AUG 79 
“=> emake signal 2 cer mtet etre terete enmnenn—=> CSMCS? sys 1) 
STATION <name> SIGNAL CHANGED 10 4 


*->. «connect ““29=ses4=°==<-= Hsaccmnenccem=> CSYCOM? sys 1) 


CONNECT INITIATED €028] fa aA 

CONNECT COMPLETED to HOST = <hostname> 
B1600/B1700 SMCS MARK IX.0.00D (08/20/79 13240) 
CS¥) LOGGED ON ~SMCS— AT 09215 08/30/79 

YOU ARE AT STATION 21 CVIRTUAL)D 


“=> AGanst Lo teen nen nnn enna nee ----------- > CSYCOM? sys 1) 
STATION SIGNAL Is "1" 
“=> Ll what -“<-9----------- ween nnn nn n-----> (CSYCOMS sys 1) 
SYCOM IX.0-2 €30 JUL 79 14253) ONLINE? IDLE 


THIS STATION CONNECTER £0281 Aa aA 


USERCCOE = SY» LOCAL KOSI = SL2» REMOTE HOST = FUB 
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Fither one of the following mayte used in place of the above 
statements. 


ON SYCCM .~CONNECT 
or 
ON SYCOM. SIGNAL 1 
1CONNECT 


CPS PCES OCC CESSES EE COCO LECLERC LECCE eS Cee Cee te: 


u Current terminal input message path assignments u 
n bs | 
m Vor anput ““so=- ee eee ee > @<xx> © @« « SMCS sys 1 a 
u Immeetrrenm> 1<xx> 2 2 « SYCOM sys 1 nm 
n 2 {oss ==s 25 > <xX> o 28 @ SMCS sys 2 n 
RAMAN HANARUAANHONNMNANKMMNKUMNMMANMMNTMOM NNN NMA NMNNKMN NNN NMA 

<-> system terete ster er nen ene ne- SSHeaesss= > CSMCS> sys 2) 

SYSTEMIC: THE HUE 


SYSTEM@TRANSLATE: ON 
SYSTEM“VERSION: Bi8CO/B1700 SMCS MARK IX.0.00D 


Now the terminal user can establish a connection to any other of 
the systems ir the stringe At this point we can make connection 


to the third system Cslave 3) by enrtering the following command: 


2=> ON USeR3 Teme enn n ners scene nnn enn > CSMCS3 sys 2) 
SIGNED CN TO "SYCOM"» SIGNAL = <?> 

B1700/B1800 SYCCM IX.0.2 (08 AUG 79 15219) 

USER SY LOGGED ON TO CUSER3)/SYCOM AT 09216244.1 ON 


It is necessary for the SMCS"s “signal character” in System~2 be 
different than that of the SMCS in the Systen71. If the “SIGNED 
CN TC “SYCOM™" message returned for the last sign-on is other 
than ~¢ *a*» then skic the next input coamands otherwises change 
the "SMCS's signal character™ in System-2 as follows: 


e--> <current signal> make sigral $8 =“"-"" “==> (SMCSs sys 2) 
STATION <name> SIGNAL CHANGED TO $ 

2"2> aconnect err sSSsrSeseee"= arent wmaenn~> CSYCOMs sys 2) 
CCANECT INITIATED £931] Aa aA 
CONNECT COMPLETED to HOST = <hostnane> 
B18@00/B1700 SMCS MARK IX.0.200D €08/20/79 13240) 
CSY) LOGGED ON ~SMCS~- AT 09217 08/30/79 
YCUL ARE AT STATION 41 CVIRTUAL) 


<-> eSignal 2  crmetmeecwe canter eres ccsnsnn= > CSYCOM$ sys 2) 


STATION SIGNAL IS "2" 
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a Current terminal input message path assignaents a 
bs | . : . P| 

u VOT input s.r oS eo > @<ux> «2 @ « SMCS sys 1 " 
a | fersecrr—> L<xx> « « « SYCOM sys 1 nu 
7 0 meter ern>  Sexx> 2 2 2 SMCS sys 2 n 
a: . Pomrsterr~> 2CxK> -« © « SYCOM sys 2 L 
3 [=sees=<=> <xx> «2 »# © SMCS sys 3. u 
RURHMRKNnUNAN awa 60 EB 6 REE AYO OT 
-=> system wer esnmeene  -eccee osaeceeeasee=~=>° CSMCS> sys 3) 


SYSTEMID= SLAVES | 
SYSTEM“TRANSLATE: ON 7 
SYSTEM“VERSIONS 81800/81700 SMCS MARK 1X.0.00D 


22> on Sal reer en nnn een nn nnn nee ennneennen> (SHCS3 sys 3) 


SIGNEL ON TO “SYCOM™»s SIGNAL = * 
81700/81800 SYCOM I[X.~0.2 (O08 AUG 79 15:19) 
USER SY LOGGED ON TO SA1 AT 09218259.3 ON 30 AUG 79” 


It is necessary for the SMCS*ts "signal éWerattec® in Systea-3 be 
different than those for system’s 1 ara 2. If the "SIGNED ON TO 
“SYCOh"" message returneo for the last signmorn is other than a 
"2a" of "S$"» then skip the next input commands otherwise» change 
the "SHCS"s station signal character*® in System-3 as follows: 


"2 <current Signal> make signél # se3""3"77> (SMCS3 sys 3) 
STATION <name> SIGNAL CHANGED TO @ - 

“-> econnect (pero eeeneee-- 22 ennnne-- ===> CSYCOMS sys 3) 
CONNECT INITIATED (028] Aa aA 
CCANECT COMPLETED 
B1800/81700 SMCS MARK IX. 0. 00D (08/20/79 13240) 
CSY) LOGGED ON “SMCS—~ AT 09220 08730/79 
YOU ARE AT STATION 41 CVIRTUAL)D 

o=> eSignal 30 caren twee nnn nnn n nnn nnn ----> CSYCOMF sys 3) 


STATION SIGNAL IS "3" 


At this points the user is now connected tor and loggedons_ the 
O9MCQ in the *SA1" systea. 
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Tee EE OCESS ESOC OCOQE COOGEE SOG CEOL SC 0-0 £2. 8 08'S tt 0-0-8101: t-0- 0-88 bE Et ELL iBT te 


an Current terminal input message path assignments n 
u , a 
a -VO)T jARbUt.. Ste ss24se5s== > “a<ux> 2 e© 2© SMCS sys 1 i 
cS Porm eennnnm> l<xx> 2 « « SYCOM sys 1 un 
n [20 ss2s "> > $<xx> «© «© » SMCS sys 2 n 
n Promtrnmnn> 2<xKx> 2 2 © SYCOM sys 2 st 
ii Pawerernn> #<xx> 2 2 © SMCS sys 3 m 
a1 Joon 2"> 3<xK> 2 2 « SYCOM sys 3 n 
a | fe=ss<=4=> <xx> 2 2 e@ SMCS sys & m 
HMMM KHMEKHAMDHMNMHN DUN NARMUNARNKNHNANNKRMANHNAKRNAUNARNANNMNNHMNHMUMHMNRNUMNMNMMHARKRE Khe 

“"> systesg «e2ee7"e> === =e = wom ewewneenwmn—=> (SMCS sys 4) 


SYSTEM=ID?: | SA1 

SYSTEM*TRANSLATE? ON 

SYSTEM*VERSION: 818CO/681700 SMCS MARK IX.0.00D 
The connections exist to attow input wessages from your terminal 
to be sent to the SMCS in the “SA1" system. At this point» one 
is free to “PASS” to prograss in that systes and/or give commands 
to the SMCS/MCP there? — 

--> co px sdilsfi cards ram CsyJ/xs dsk> se=> CSMCS> sys 4) 


CSY¥} PX =<job #> BOJ. PP=4» MP=4 TIME = 09211:°17.6. 
CSY) PX =<job #> EQJ. TIME = 092123259.8 


“=> a system 1a, “Seer eseers= == Ss See es eS = > (SMCS sys 1) 
SYSTE¥“ID? SL2 

-“-> §$ syeeee ae Saeaencs ese SS'ese2=SS=S<> > CSMCS$ sys 2) 
SYSTEM"1TO:2 THE.HUB- 

"=> £ S¥Sten: 40 .==coresere sss et ene eee eee ae > CSMCSs sys 3) 
SYSTEM“ID: SL3 

=> DL NNSG AT SS seer hsoer=ac= aaa tla > CSYCOMs sys 1) 


SY¥COM IX%.G.2 €30 JUL 79 142353) ONLINEs IDLE 
TEIS STATION CONNECTED £C€2@] Aa aA 


USERCCDE = S¥> LOCAL KOST = SL2> REMOTE HOST = HUB 
==> 2 what eee ee eee ee eS Ss oe ee Se Sema Swe oe wwe > CSYCOM> sys 2) 


CUSER3)/SYCOM IX.0.3 (08 AUG 79 15219) ONLINEs IDLE. 
THIS STATION CONNECTED [C411 Aa aA 
USERCCDE = SY» LOCAL HOST = HUBs REMOTE HOST = SLAVES 


SS sf Mt, FSS eSS SOS e Sse tee SSoSs ser > CSYCOMs sys 3) 
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SA1 IXs0-3 €08 AUG 79 15219) ONLINE? IDLE. 
THIS STATION CONNECTED £040] Aa aA 
USERCODE = SY» LOCAL FOST = SL3» REMOTE HOST = SAI 


--> ex dmapall>fi outpefile inv 2spr 113 
(SY) DMPALL =<job #> BOJ. PP=115 MP=11 TIME = 0932221 


2% OMPALL =<job #> ENTER SPECS. 
CSY) CMPALL =<job #> ACCEPT. 


--> <job #>AX COPY CSKLSE SMCS/TRACES 


% DMPALL =<job #> ENTER SPECS. 
(SY) DMPALL =<job #> ACCEPT. 


“-> <jok #>AX | 
(SY) DMPALL =<job #> EQJ. 0922321122 


After all transactions with the SAl system have been completed>s 
all connects must be “disconnected". This can be accomplished 
with the following List of coamands: CAgain»e by giving a *bye” 
command to each SYCOM in the chains the “station signal 
character™ is restced to “.” arc the virtual station is 
autogatically “disconnected”. ) . 


-=> 3bye ee gna Oye Oe ee, eS pea see wre eye Ve CSYCOMs sys 3) 


STATION DISCONNECTED | 
USER CSY) LOGGEO OFF SA1 AT 0922323321 ON 30 AUG 79 
DETACHED FROM "SAi" | 


c->  2bye wren eee ennn ono -- eteccen- secrcem> CSYCOMS sys 2) 


STATION DISCONNECTED _ 
USER CSY) LOGGED OFF. CUSER3)/SYCOM AT 09233223.7 ON 
DETACHED FROM "USER3™ 


“=> Idisconnect rte crt ttre teen eesnnnn---> CSYCOMS sys 1) 
STATION DISCONNECTED 


“-> what  ceccsecess---- orc tateccennanen=2=> (SYCOM) sys 1) 


SYCOM IX-0-2 (30 JUL 79 14253) ONLINES IDLE 
THIS STATION NOT CONNECTEC 
USERCCDE = SY¥» LOCAL HOST = SL2» REMOTE HOST = HUB 


B9>  by@ tan ee nnn ne nnn ne ene een e nn nnnnn-> (SMCS? sys 1) 


CSY) LOGGED OFF SYCOM AT 09:24:09.1 ON 30 
DETACHEO FROM “SYCOM" 


gaaie yd 
AUU a9 
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At this point» control of the termirel has reverted to the SMCS.. 


The *O0FF command may be used instead of the above list of 
discornect commands. The *OFF will disconnect one comptetely 
where as the above disccnnect ccas#ands wsust be done one input 
message at a timee 
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GENERATING NETWORK CONTROLLERS 


GENERAL 


This section is provided as a user oriented guideline to the. 
generation of a Network Ccntrottler for the SYCOM systen. The 
contrcller is cenerated by the Network Definition Language (CNDL)D 
compiler usine a prepared set of NDL specifications. The system 
user 1S required to determine these ADL specifications according 
to the system configuration and ernvirongent under which the 
Network Controller is to function. , 


The fcllowing guidelines are offered for a target system that is 
to provide the full range of SYCOM services including terminals. 
They ere intended. tc aid the user itn generating a Network 
Contretler with correct functional attributese For a complete 
description of the NDL specifications and definitions» refer to 


the "Network Definition Language reference manual" Cassociated 
documentatian). a 


DETERMINING THE SPECIFICATIONS 


The fellowing sample Network Controtler NDL specifications are 
presented in a sequence similar to that of the NOL reference 
manual. This allows the user a logical reference for evaluating 
the sample NDL specifications for application to the tnstallation 
requirements. They identify suggested parameters which produce 
an cperational Network Controtter program fcr the SYCOM system 
configuration as specified. 


OPERATIONAL PROCEDURES 


The fcllowing procedures provide the methods by which the user 
prepares the input to the NDL compilation processe generates a 
Network Contrcllers and induces wfadifications into the resident 
NDL compilers if required. 


PREPARATION OF INPUT 


The NDL *source™ input file can be prepared ir the fora of either 
a carc file or a ADL type disk file. The disk file could he 
created and maintained using CADE or another text editor of 
similar capabilities. 


The “Saapte NCL Parameters File" is furnished for the purpose of 
creating this file with the most agcunt of accuracy in the least 
amount of time. Any adjustments tec this source file for number 
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of lines» terminals» and other such attributes is’ the 


resrorsibility of the user which is attuned to the system 
configuration and its operational environment. 


en eon PFOCESS 


Prior to initiating the NOL compitaticn process» the user should 
ensure the presence of a “10.0 NOL/LIBRARY™ file on disk» of a 25 
Oct 1$80 or Later vintage). Then» there are several methods by 
which the NOL compilation Cgenerative) process can be invoked. 
Poe yee ang are two of these methods: 


Card Input: 

Following is a primitive example of a NOL source card input 
deck: CThe <I> in the exaaple Lelow represents an “invalid” 
character as required by the MCF.) 


<I> CO USER/NC NCL LI 
<I> DATA CARDS 


NOL source images. 
NADL Library calls 


<I> END 


Disk Input: 

This method is used to initiate a NDL compiler process when 
the source irput file resides or disk. Enter the following 
*CP command using the systea ODI: 


CO USER/NC NEL LI*FFI CARCS ANAM USERNC/SOURCE OSK DEF 


From this point ons the compilation procedures are the samee 
When the MCP executes the NDL comnvilers a noraat “BOJ”" message is 
displayed- Upon successful coapleticn of the compites the noramat 
"EOQJ" message is displayed. However» if an error message such as 
the cre below is displayed: 


ADL 2 USER/NC =<job #> --EVALLATION/PROGRAM POINTER STACK 
OVERFLCW DS OR OP 


Then the “NDL Comspitler™ must be mocified to increase its “name/ 
value stack" size. 


PRINT THE USER/NCNIF FILE 


Once the compilation/generation cf the Network Controttler is 
complete» it is suggested that the "Network Information File™ he 
printed. This ts accosplished ty executing the. following 
progr das and providing the correct file nase Cif differ 

the one suggested): 


me than 


enc tna 
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EX NIF/ANALYZERS FI NIF NAM 


NIF/ANALYZER =<job #> BQJ. 
NIF/ANALYZER =<job #> E0J. 


SAMPLE NBL SOURCE FILE CLOCAL US 


Following is a sampte NDL source 
NDL compiter for the generation 
to a tser System. This example 
which services a locat site of 3 
and a intermsystem connectione 
Network Controiter specification 
installation Ceegs» more/tess Lo 
termirals» etc). 


This sample ANDL tinput file is 
and péerameter specifications. 
will provide the correct functi 
operation of the SYCQF system; 


Se if gst ls 


% 
$ LIBINFO 

$ NSSIZE 20 

$ VSSIZE 15000C 
LLLAULAUL ILLIA ITI AIA 
z 
z 
x 
VLU AAA AL ALLL ALLAAA AULA ALLL UTA AEN 


Bhhnbhas 


Declaratio 


DECLARATIONS 
NIF = "USER*/*NCNIF™. 
MAX FILES 16. . 
MAX BUFFERS Ze 
MAX MESSAGES 20. 


LIBRARY SYCCMDEC 


RARER ALAA AAAAR ALAA 
ys 
rs 
a 
ALAA A LL ARLE LAL EAA AAL EAE LAZAR 


Requests an 


LIERARY 
LIBFARY 
LIBFARY 
LIBRARY 
LIBFARY 
LIBRARY 


SYCOMREO 
CANDEPOLTD 
CANCEFSLTO 
SYCOMCTL 
CANDETOCTL 
SYCOMREG 


4 4 HO & & 
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USER/NCNIF<etx> 


-PR=4 TIME 
TIME 


11205227.1 
11°07°212.9 


ER SYSTEM) 


file to be used as input to the 
of Network Controller oriented 
rravides a Network Controller 
terminals» 2 virtual terminals» 
The user must tailor this sample 
s to the needs and desires of the 
cal terminals» more/less virtual 


c 


corrrised of both NDL stateaents 
The resulting Network Controller 
onal attributes necessary for the 
in testing mode. 


Z nuater of ertriess 
2 nusber of bits» 


for IOLOG 
for IOLOG 


RAL EAAAARALARARU ATLL U AL AAA AL EREE 
| pA 
z 


Zz 
CALL ALARA AL ALARA AERA L ALAA ALAA AAI 


n Section 


% NIF file nawger user option 


LARVAL ALAA ATLL AAAAAALAAAAAL AA 


d Cortrols 


aren Ne 


RRA ZEA LALA AL AAA ALL AL ALALAAAL 


Z*xx 
ras | 


Ze 
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LLL AULA UL ALLA ALAA AAA LTE LAE LLL ALLA LL LLL LLL ALLL LANN 


4 . z 
y4 Network Configuration z 
r : z 


SEPEESSESSSSS LOSES SS SLO SESS SELOSSSESELSSESELESSOSSE SLOSS LS SS The 


ESE SELSESTSSELSSIS TES SSESTRSSSSESEU SES SESE SELES SAAS SSS ST ET SESS: 


4 | z 
y4 Terminat Sectior Z 
x y 4 


LLL ULLAL ALIA UAL ULLAL INIA ALAIN MII IMAI IIIA AIIM AIA IAAL IAA. 


TERMINAL DEFAULT SYCOMDEFAULT? 
REGLEST. = SYCOMREQSRECEIVEs SYCOMRECG: TRANSMIT. 
TRANSMISSION = 1. 


ADDRESS = 2. % Nuwber cf polling address characters 
BUFFERSIZE = 3840. © Z 2 x 1920 Lytes 
TYPE = 62. | z 81800 


TERMINAL SYCOMTERMINAL: 
DEFAULT = SYCOMDEFAULT. | 
TERMINAL DEFAULT TOFLT: lee 
RECUEST = CANDEPOLTD:RECEIVE> Z*#* 
| CANDEFSLTO: TRANSMIT.Z## 


TRANSMISSION = O- . Z% 
ACDFESS = 2. : Yan 
TYPE = 44. . Zx*« 170820 
BUFFERSIZE = 2250. Zet 
TERMINAL TO0824:5 Za 
DEFAULT = TOFLT. Lx 
LEATA AAA ALLA AU Z ALLA A LARA AAA A LANZA RAL ALARA AAA LEAL ALAA ALLL ALAA 
4 z 
z Station Section y 4 
yd . y 4 


EEA A AAR IAAL AA AULT A ALAA ALA AAAAR AAA 


STATICN DEFAULT SYCOMDEF : 
FRECUEACY = 250» 250. z . WCS Controtler 
MYUSE = INPUT» OUTPUT. 
TERMINAL = SYCOMTERMINAL. 


RETRY = 25. 
STATICN DEFAULT TCSDF: Ze & 
FRECUENCY = 2495 249. zZ**x KonmRemcote ODT 
MYUSE = INPUT» QUTPUT. Zee 
TERMINAL = TDB24. R** 


RETFY = 4&e | Lx 
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LLLAALALARLAUAAL ALAA AALAL LALA LL LUA AL ALLL AZUL LLL LLL AA ALLAAH 


2% If any RJE station are required fer “RJE/HOST"» then they 


2% must be dectared LSN"s 1: = 45 ne excepticnSeccacssccves 
STATICN CONTRCLST1: 7 (SS ee 
DEFALLT = SYCOMCEF. x {sn 001 1 
ADDRESS = "00". y 1 
| z i 
STATICN SPOST2: rd 1 
DEFALLT = SYCOMDEF. -Z isn 002 1 
ADDRESS = "01". Zz 1 Must be grouped. 
Z 1 
STATICN CARDST 3: yA e  Seee s Seceses5=42 
DEFALLT = SYCOMCEF. t isn 003 | : | 
ADCRESS = "02". r4 ! Don*t have to be 
2 i first stations . 
STATICN PRINTERST4:2 Zz { defined. 
DEFAULT = SYCOMCEF. a isn 004 ! 
ADDRESS = "03". ra 1 
z t 
STATION FILESTS: 2 1 
DEFAULT = SYCOMDEF. x isn 005 ! 
ADCRESS = "C4". z onan enone 


PESESESSILSSSSSSESLESSSSASESSSSSSSSCESSSSISSSL ELST ASE SS SESS ESTE: 


STATICN USERT1; | isn 006 * Virtual terminal 
DEFAULT = SYCOMDEF. CODT/terminats) 
ADDRESS = *"Aat™s» "3A". 


STATICN USERT2: 
«DEFAULT = SYCOMDEF. 
ADDRESS = "Pa™» "apm. 


tsn 007 * Virtual Terminal 
(Program) 


Nine re NM Ee 


LL AAULAL LLL LUL LALLA LLL LLL LILIA ILIA IMAI MII AAA IAAI IID 


. Lek aemeeoereoes= 
STATICN Ris Lk& isn 008 1 
DEFAULT = TC8DF. Lux i 
ADDRESS = *h1". Leek | 
FRECUENCY = 2495 2506. Z*#* Rewote ODT I 
Let ' 
STATICN R25 Zax isn 009 1 
DEFAULT = TC8OF. Lk > Local terainal 
ADDRESS = “f2". ; Zee | 
FRECUENCY = 2492 250. Z*xe Remote ODOT I 
. Zak i 
STATICN R35 Z** tsn 010 1 
DEFAULT = TC8DF. Zxk | 
AQDRESS = "R23". Z*% ' 
FREGUENCY = 249% 250.6 Z** Remote ODT | 


Lxkz& se ewrweeceres= 
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REE Z A EAA KALLA LL ALATA LLU A ALL LAL ALAA ALZ 


z . z 
z Line Sectior y 4 
z y 4 


LAAABLARAAAZA ANAL UAL LL LK LL ALLL ALAA ALLL LUA ALA ALLA ALLA LAL AL LALA 


LINE CIRECTOI: 


CONTROL = SYCOMCTL. : ; bos 
STATION = CONTROLST1i» SPOST2> CARDST3o PRINTERST4» FILESTS» 
USEPT1l» USERT2. | . 

ACCRESS = 1:0:6. Zz Cline» adapter» ports system) 
LENE CEFAULT LINEOFLT?: Zee 

CONTROL = CANDETOCTIL. Ree . 

AUTCPOLL = 15. Z*e® 5 x max Stattons/lines 
LINE PULTIO4s %** adapter 4 

DEFALLT = LINEDFLT. | Lx 

STATION = Rie Ree RE. Lax 

ACDRESS = 12024. Z*« (lines adapters ports system) 


LLUA AULA ALLA AAA AEA ALALA ALAA LALA ARK AL AL ALL AA ALTL LAL AAALAL LLL ALALALY 


FILE LINK: | % fer SYCOM 
FAMILY = CONTROLSTL» SPOST2» CARDST3» PRINTERST4s» FILESTS» 
USERTL. X% ersn'*s OOl» 002+ 0035 O04» 
z 005» 006 le, 
FILE RFUSER: | % Fer program=to~program I/0- 
FAPILY = USERT2. Z rsn 001 
FILE TERMINALS: Z*% = 8Thkis file is named “TERMINALS” 


%** when SYCOM is run without the 
Z** SweCSe- I[t must be named 


. Z#* “MCSREMOTE* when SYCOM is run 
. | zx** subordinate to the SMCS... 
FAMILY = River R2e R3- Zee rsn*s O01» O02- 003 


ALAAVAALLAAL AAA ALA ALAA LAL ALALL ALA UAU ALL LALLA ALL ALLL ALLL LL ALAALLLLZ 
FINI. 


an wee oo an a ah a a ee a en oe ae eee a fff ee a en ne ee em ee ea Oe Oo me 


Note: If the User System does not have “local terminals” then 
alt tines in the above exéeple with comments indicated 
With "Z**" can be omitted from the source file. 


SAMPLE NDL SOURCE FILE CREMOTE SERVER SYSTEM) 
collowing is a sample NDL source file to be used as input to the 


NOL coapiler for the generation of & Network Coentrottler oriented 
to a Server Systen. This example provides a Network Controtler 


8-7 


BURROLGHS CORPCRATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP 81800/81700 sYcoM 
SANTA BARBARA PLANT Pe Se 2219 0458 CA) 


which services one remote site of rc terminals» an inter-system 
connections and a SMCS. The user sust tailor these sample test 
Network Contrctier scecifications to the needs and desires of the 
installation Ceeges more/iess local terminals» smore/tess virtual 
terminals» etc). | 


This sample NDL input file is cosprised of both NDL statements 


and parameter specifications: The resulting Network Controtier 


will provide the correct functional attributes necessary for the 
operation of the SYCOM system> in a test modee 


$ CONTROL 
$ LIBINFO . : : 
$ NSSIZE 20 % ruater of ertriess for IOLOG 
$ VSSIZE 150000 Z nuagber of bitss for IOLOG 
DECLARATIONS 

NIF = “SERVER*/*NCNIF". % NIF file names user option 


MAX FILES = 16. 
MAX BUFFERS = 2. 


ce - n 
MAX MESSAGES = 20. 


$ LIBRARY SYCCMDECL 


$ LIBRARY SYCCMREC 
$ LIBRARY SYCOMCTL 


TERMINAL DEFAULT SYCOMDEFAULT: 
REQLEST = SYCOMREQSRECEIVE» SYCOMREQSTRANSMIT. 
TRANSMISSION = 1. 


ADCRESS = 2. | % Number cf polling address characters 
BUFFERSIZE = 3840- 2 2x 192C bytes 
TYPE = 62. % 81800 


TERMINAL SYCOMTERMINAL?:. 
DEFAULT = SYCOMDEFAULT. 


STATICN DEFAULT SYCOMDEF: 
FREQUENCY = 250° 250. 2 MCS Controller capability 
MYUSE = INPUT» OUTPUT. 
TERMINAL = SYCOMTERMINAL. 
RETRY = 25. 


RARE L EAA ALAA LALLA LZR AA ALARA AAA AL ALLEL LALA ALAR ALLL 


BURROLGHS CORPORATION 


COMPUTER SYSTE*S GROUP 


SANTA EARBARA PLANT 


STATICN CONTROLST1: 


DEFAULT = SYCOMCEF. 
ADDRESS = "00". 
STATICN SPOST2: 
DEFAULT = SYCOMCEF. 
ADOFESS = "01". 
-STATICN CARDST 3: 
DEFAULT = SYCOMCEF. 
ADCRESS = "02". 


STATICN PRENTERSTA? 
DEFAULT = SYCOMDEF. 
ADDRESS = "03". 

STATICN FILESTS? 
DEFALLT = SYCOMOEF. 

ADDRESS = "O04", 


STATICN SERVERTIs 


DEFAULT = SYCOMCEF. 
ADDRESS = "aA", “Aa" 
STATICN SERVERT2: 
DEFAULT = SYCOMOEF. 
ADDRESS = "aP™» “Pam 


LINE CIRECTOL: 


CONTROL = SYCOMCTL. 
STATION = 
SERVERTIL» 
ACCFRESS = 1:2026. 
FILE LINK: 
FAMILY = CONTROLST1> 


FILE RFSERVER: 
FAMILY = SERVERT2. 


FILE PCSREMOQTE: 
FAMILY = SERVERTI. 


SPOST2. C 


NEN HM De HM PREP Pe 


COATROLST1» SPOST2s CARDST3» PRINTERST4> 


SERVERTF 2. 


NMRN HRN MNN NM NN MM MN MM HER NM 22 
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isr 001 


! 
{ 
1 
! 
002 1 
1 
! 
1 


Lsr 
Must be grouped. 
bLsr 003 > seeeteereewnn a 
, . 
{ Don*t have to be 
ee | first stations 
tsr 004 $ defined. 
! 
{ 
1 
tsr 005 1! 
1 
1 
isn 006 * Virtual terminal 
CODT/terminals) 
Lsn 007 * Virtual terminal 


(CPrograa) 


FILESTS» 


% (line» edapter» port? system option) 


r 4 


zZ 


mn 


NRNRNN HK 


fer SYCOM 


ARDST2» PRINTERST4» FILESTS. 


rsn*s OO1s O02» 003% O04 005 
Fer progrags~to-program I/0. 
rsr OO1 

Ncte? There is onty 1 device 
defined here because the 
staple test program is a 
sirgle user program. 


This file is used for the 
virtual terminals assigned 
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Z tc Server System's SMCS. 
Z2 esr 001 
FINI. 
memes see naam seas ereeaesee VIIA frm cmn nce tc err cse scenes scert esse 


Source configuration notes: 


The Network Centroller source file for a Server System “with 
local terminets™ is configurec by appropriately adding the NOL 
statements identified in the User System example with "Z%«es" as 
comments. | 7 | 
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GLOSSARY OF TERMS AND ACRONYMS 


Systesas Communications Modute CSYCO*) 20 Dec 1979 B1800 Series a 
Software Cperationalt Guide Page = 210 Section VIII Glossary" of 
Terms and Acroryms CRevisior "C™). . 


This glossary defines SYCOQM terms and acronyms used throughout 
this software cperaticnal guide. For ease of uses the glossary 
is separeted into two sectionss Ter@s and Acronyms. Each 
section is sequenced atphabetically for quick reference. 


TERNS © 
TERM = DEFINITION 


ACTIVE STATION: | ; 
A work station Cterminat) that ts currently eligible for. 
entering or accepting messagese 


AMERTCAN STANDARD CODE FOR INEQRNATION INTERCHANGE CASCII)= 
This code» established by the American Standards 
Association» defines codes for a set of characters to be 
used in the itinterechange between business equipment over 
telephone and teleqraph circuits. The code consists of 128 
graphic and control characterse 


APPLICATION PROGRAMS 

A program that processes data and is unique to one type of 
epplication. It is sometimes referred to as a “user 
prograa@a™. 


AUTO CALL UNIT: | 
A device furnished by the cosmunications cogamon carrier 
which altows a User System to automatically establish a 
dialed tink tec a Server System over a communications 
network. 
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TERM = DEFINITION. 


BEGINNING OF JOB (8Q0J)=: : 
The executton of a 1 single prograr unit to be performed by 
the systems | 


BINARY CARD: 3 | : | 
A punched card with gultipte punches in any one or more 
columns which represent a non-ASCII character. 


II 


The smatlest unit of informatior in a binary systen. 


EITS PER SECOND Coos): 

The expression bits-per~second is used tc express the speed 
at which bits of data are transmitted over a communications 
channel or interrally soved wittin a computer syste. 


BLOCK: | 
A group of characters/bits trarsmitted as a tee ata unit of 
datae Also» see Block Check Character. 


BLOCK CHECK CHARACTER (BCC): 


The Block Check Character is a characuer appended to data 
-Elocks trans@sittec for the purpcse of error detection and 
parity control. 


BLOCKING FACTOR: 
The maximua number of characters attowed per single 
transmission. 


BROADCAST: 
The simultaneous dissemination cf inforsgation to a number of 
work stations Cterminals). 


BUFFER 
This iS a temporary storage area that is used during the 
transfer of data from one device to another. It is atso 


used to compensate for variaticrs in bit rates or timing of 
events within the system. 


CARRIAGE CONTROL: 


Controls the vertical paper sotion tor a line printer. 


CHANNEL: 
A device that directs the flow cf data between a computer's 
Rain memcry and input/output devices. 
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TERM 2, DEFINITION 

CHARACTER: | | 

A digits» Letters or special character. (Letters can be both 
upper or lower case.) 


COMMON CARRIER> 
A company» such as 3elt Telephone» that provides 
communication lines as a public service. 


COMMON CARRIER EXCHANGE: - 
A defined geographical area» served by a communications 
carrier» within which the carrier provides this service. 


COMMUNICATION LINE: | | 
Any medius» such as a wire er @ telephcne circuit» ~~ that 
connects a terminal with the cosputer. 


CONDITIONED LINES: 

These are private and teased transmission lines that are 
conditioned to reduce data cistortion while providing 
transmission cf data at lower errcr rates. ; 


CONNECTIONS 7 ; 
An established data transmission path between two or more 
computer systense It is consicered either a temporary or 


crerpanent connections depending on whether it ts established 
with or without switching facilities» resrectively. 


CONTROL CARD: | 

A punched card which contains information which identifies a 
job or describes its requiresgents te the MCP. The first 
column must contain an invalid character (80 column cards) 
cr a question mark *?" €96 colurgn cards). 


CONTROL STATE: 


Ihe term “control state» fcr this system» refers to a 
program that can assume control cf the system"s processor 
with privileged operands. As a rules the type of 


controi=state program suggested here infers. an “operating 
system" or MCP. 


CONVERSATIONAL MODE: 


An operational mode in diveen fessage data. Cfull or partial 


fessages) is used in lieu of» cr in addition to» controt 
characters as replies for messace information. 
QATA 


Cata is any represertation cf informaticns such as graphic 
characters» to which meaning might be assigned. 
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TERM 3 DEFINITION 


DAIA COMMUNICATIONS: | 
Cata communication ts a method cf transferring encoded data 


by means of electrical trarsmissions between two or more 
tergsinals and/or systeas. 


DATA COMMUNICATIONS SYSTEM> 

A data communications syster which consists of two or more 
computer systems that are Linkec be means of a communication 
line(s) for the purpose of data exchange. 


CAIA LINK 
A composite of computer systees and the interconnect- ing 
retwork» together with control procedures» operating in a 


rarticular mode that permits irformatior to be exchanged 
tetween these systems. 


DATA SET: 
A device that provides an interface between a data 
communications system and a data communications line. Most 


cata communication tines use a modulated carrier for data 
transfer. The datacset provides the logic to modify the 
cata that is being received cr transrmitted between terainals 
and the system. . 


DATA SET READY: 
&£ signal providec by the Data Set. 


LATA TRANSMISSION: i 
Cata transmission consists af transmitting data between. two 
or more computer systems in a system networke | 


DISCONNECT COEQT)= : 

The term Cand mnemonic) for the *DLE E0T* communication 
control sequence which is used to stgnal that a "disconnect® 
cf a switched circuit sust be iritiated. 


QDIAL~QuT=: 
The use of an Auto Catt Unit to establish a "switched" 
connection between two €2) computers. 


DIAL-UP: . 
The use of a dial or touchtone data set to establish a 
"“switchec™ connection between tne (2) computers. 


RISK CARTRIDGE: | 

A secondary data storage device much the same as a “disk 
cack™ but usually smatler tn size. It can be moved  ontine 
cr cfftlire. 
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TERM = DEFINITION 


RISK DERECTORY: | | | | 

A disk~resident table that contains the name and type of 
file» together with a pointer to the disk fite header or 
sub-directory for all permanent files which reside on disk. 


DISK PACK: | | 
A secondary data storage device that can be moved online or 
cffline. 


DISK“PACK"IDENTZFIER Cdo-ig): 
An identifier which is the name assigned to a disk pack or 
cisk cartridges 


EXTENDED BINARY CODED DECIMAL INTERCHANGE CODE CEBCDIC)= 


A code consisting of 8bits nhich 1s used to represent 256 
unique letters» numbers and special characters. . 


ERROR: 


Any received character or 
not confora to those tr 


error. 


ce of characters that does 
ec Tre considered to be in 


ERROR RECOVERY PROCEDURES: a 

These are data communication control procedures used _ to 
restore normal operations tec a data link after an error 
condition has occurred. . 


FAMILY NAME: 
A identifier used as a file rare» or the name assigned to 
identify a main file with sut-directory entries. 


FILE SECURITY: 
The procedures or special devices "used to prevent access to 
cr use of data or programs withcut authorization. 


FILE IDENTIEIER? | 

ALL disk file~identifiers used cn the system must be unique 
to prevent cupdicate file-nafes. A file identifier can be 
comprised of. any combination of the foliowing file- 
identifier options: 


- file-identifier 
- familycname/file-identifier 
- dprtid/farity*name/f ile-identifier 


HALE-OUPLEX CHANNEL: 
This is a communication chanrel in which the signaling may 


te in either directions but not air _ ~oboth directions 
simultanecusly. 
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TERM = DEFINITION 


HALESDUPLEX JRANSHISSION: 

This is a type of data transmission where information is 
sent in anly one direction at 2a time. It cannot send data 
in both directions simultaneously. 


HARD COPY: 


Cenerally» the printed copy of some material in a readable 
form ts considered to be “hard copy. This would inctude 
computer printec media such as Reportse Listings and 
documents like this Software Operationat Guide. 

IDENTEZEIER= | 

A word consisting of from are to seventeen numerics 
eiphabetic» or special characters in combination. 

INIEGER= : 

A whole number as opposed to a fractions that is» a nuaber 


that contains the unit of (1) an exact number of times. 


INTER“SYSIEM COMMUNECATIONS:= 
The ability for a terminal or frogra# in one system to 
comeaunicéte with a program in arcther systea. 


JNIBATSYSIEN COMMUNICATIONS: 7 
The restricted ability for a tersinal or program in a systen 
to comsunicate with another program in the same system. 


1408 
A “job” to this system is any frogram that is executable 
under the control of the MCPs SYCOM is a job. 


J08 NUMBER: 
A unique nuaber asSigned by the system's MCP to each job 
that is executed under its control. 


398 SPAWNING: : : 
The abitity for a user to execute jobs under program controi 
and maintain an adequate level of control over those jobs 
Curing their execution. 


KEYBOARD: | 
A device for the encoding of data by key depressions which 
Causes the generation of the selected code eleaent. 


LEASED LINE: 
A data transmission line reserved for the exclusive use of a 
customer Cdata center). 
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TERM = DEFINITION 


LIKE SYSTEM: | 

A "Like system" is a system with the physical 
characteristics similar to those of a target system. For a 
2180900/81700 system» a “Like” system would be either a B1800 
or 81700 system. . 


LINE? 
‘fp data communications Line tirking two (2) computers or a 
computer and its associated terainalse 


LINE ADAPTER: 

A line adapter consists hardware and/or software togic used 
to interface a data-set or communications line into a 
wultirline or singte-line I/0 certrolt unit. 


LINE SWIICHING: | 

The technique of temporarily connecting two communications 
Lines together so that twe ccsputers ard/or a computer and 
its associated terminals can exchange data. 


LOS~ OFF: 

The procedure by which a user erds a data exchange session 
either between two computers or between a computer and a 
terminal. 


LOG-ON= | | 
The procedure by which a user establishes a data exchange 
session between two computers or a computer and a terminal. 


LOGICAL STATION NUMBER CLSN2: 

The identification number assisred by the Network Controller 
to a given station Cterainal). The Logical Station Number 
has no relationship to file-nases» but is determined by the 
crder in which the stations are defined in the Network 
Controtler. 


MASTER CONTROL PROGRAM CMCP):=: 


The Master Controt Progras is the master “control state” 
program Cooperating systes) used in aff 81200781700 series 
computers for systea@ control. 

MESSAGE: 

A sequence of characters arranged in a form suitable for the 
eurpose of conveying informaticr. A message contains” the 


data to be conveyed (the text) ard may» in additions contain 
communications characters to aic in the routing or handling 
cf the messagee MESSAGES A secuence of characters arranged 
in a fore suitable 
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TERM 2 DEFINITION 


MESSAGE FORMAT? 

A message format defines the placement of message elements 
within the message text. These elements would be such items 
2s? message header» control chéracters» and text data. 


MESSAGE HEADER= 

Every message moved between a terminal and the SMCS» or = an 
epplication program for that eatters is prefixed with a 
"message header”. This header contains the station 
éttributes necessary to identify the station when the tie 
comes to return areply message. . 


HESSAGE NUMBERING: 


Message numbering is the secuencing of the messages 
transmitted by the comaunications systes to ensure that all 
messages sent are in turn received. 


KODEN: 


Same as “Cata Set™. 


MULTIFILE IDENTIFIER CHe-10): 


A generalization for a group cof files with the saae “family 
name™ but with different file names. 


MULTISLINE CONTROL CHLE2: 
The CMLC)D ts an I/0 control device that provides the 
functional control between computer hardware and the line 


edapterse The controt is an integral part of a multi-line 
communications sub-systen. ‘ 
RETHORK= 


A nuaber of data communication lines connecting the User 
System with remote work stations Cterminals). 


RETHORK CONTROLLER: 

The NDL generated data corsurication program used by SYCOM 
to interface with the work statiors (Cterminats) and other 
SystemSe . 


NETWORK DEFINITION LANGUAGE CNDLJ= 

descriptiver free-form languages for defining and 
nagiesenci as a data commurications network. The NDL 
cospiler anatyzes the input statements and generates a 
custom Network Controller. . 


WORNAL STATE: 

The term “normal state” for this systems» generally refers to 
a2 program which has no facilities to seize control of a 
system's processors as aonposed te “control state". CGeJeon 
SYCOM is @ normal state progras.) 
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TERM = DEFINITION 


PSEUDO CARD READER: | . 

In a 81800/B170C system» a pseudo card reader is in fact a 
disk file. The disk file may be created via cards» program 
cutpute or through a-terminal. When a program requires an 
input carc file» the pseude card reader can be substituteds 
as that file carn be appropriately tabeled. 


QUEVE: | | | 
A togicat cottlection of messages awaiting trans#isston or 
processinge . 


REMOTE wOes= L- 7 
‘Submission of control stateaents and data from a eremote 
station Cterminal/computer)» causing the job described to be 
scheduled and executed at another system. . 


REMOTE JOB ENTRY CRIJEQ= 
The Remote Job Entry program is a method by which a remote 
computer executes or complies programs sent to it by other 
cosputerss which are considerec terminal devices. 


REMOJE SUPERVISORY CONTROL STATION CRSC): 


This is. an input/output device located on a User Systean 
(remote to a Server System) which provides the operator with 
the ability to control jobs and to request information § frog 
the Server Syste. 


RAJEZ TERMINAL: 
The official mame for the software system from which SYCOM 
derived its basic capabilities. 


RJE STATION: 

For this system» the terms “RJE Station" and “User System” 
gre equivatent. The new ter®w is used to denote a systen 
with many additional capabilities and potentials» therefore» 
the term “RJE Station” is no lorcer appropriate. 


RELATIVE STATION NUMBER CRSN2= 


Is the position within the Rescte File family? - assigned at 
generation time. 


SEMANTICS: 


The relationship between syasbols and their meanings. 


SERVER SYSIEN: | 
A Server System is a passive syste which provides computing 
services to the "User Systegse"s tLocatly cr remotely. 
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1ERM : DEFINITION 


SESSIONS . eet 
A period of time during which a user engages in. dialog 
“bketween a terminal ard a computer or between two computers. 
(The elapsed time between when the user logs~on the system 
end when the lLogwoff occurse . 


SESSION NUMBER? a | 
A unique number assigned oe a criginating system to each 
sessions : 


SINGLE LINE CONTROL (SLC) 
This is an 1/0 contrcel device that provides the functional 
controi tetween a computers wsair frame and a line adapter. 


This control is an integral part of a single line 
communicetions sub=syster. | ; 
SITE 1D: 


A unique 17-character identi tice sent in a special message | 
format to a server system prior to being togged-on to. 
provide a positive means of identific ations independent of 
zeny cther system securitye. 


‘$P0 Log: | | 
A disk file that contains all input/output messages sent to 
end received from the User ODT. 


SPOOLING: 

The reading and writing of input/output ene streams on 
secondary storage devices» in ~ format convenient for later 
cutput operations and/cr processings 


STATION: | 
Same as “TERMINAL"™. 


SWITCHED LINE: | 

A communications Line with which a temporary connection 
tetween a User System ard a Server System is established by 
dialing. 


SHIICHING: | ; : | : 
This is an operation involving the inter-connecting of 
circuits in order to establish a tesegporary communications 
link between two or more syste#se 
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TERM 3 DEFINITION 


SYNCHRONOUS TRANSMISSION: | | | 

A data transwission process in which the sending= and 
receiving devices are cperating continuously at 
substantially the same frequency and are: maintained» by 
means.of corrections in a desired phase relationship. 


SYSIEN DISK: 


A disk pack or disk cartridge that is initttalized as a 


System pack. A syster pack is under control of the MCP and 
cone or more must be presert ona system for the MCP to 
function. Head-per~track disk is always considered systen 
Ciske | 

JERNINAL? 


This is an input/output ‘device designed to receive and send 
- source data in an environment associated with the job to be 


rerformed. Further» it is capable of sending entries to» 
and obtaining output from, the system of which it is a part. 
JEXI: 


A sequence of characters forming the information to be 
conveyed between systems and/or terminals and systems. 


JRANSMISSION: 


Sage as Data Transmission. 


IRANSMISSION SLOCK: ; 

A transmission block may contain atl or part of a message 
tlock and is independent of the sessage(€s) from from which 
its characters are taken. 


IRANSPARENT MODE: 
An operational mode in which alt coded combinations of 
eight-bit characters are allowed as message text characters. 


UNIT OLVICE IDENTIEIER Cudid=: 
The mnemonic identifier assigned to each peripherat device 
ettached to the system. 


USER gDT: 
The User Systea'"s Operator paescay! Tersirat CODT). ! 


USER SYSIEM: 

A User System is the active participant system providing 
local service to the user wishing to utilize another 
computing resourcer tlacally or remotely. 
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TERM =: DEFINITION 


USERCODE | 
4 symbol which consists of fro one to eight characters to 
identify the system uSere 


VIRTUAL TERMINAL? | 

A Logical communications. capability which permits a 
terminal» OCT» or program in cne system to "interact™ with 
an application program in ancther ay steas 

yoIz ) | - | 
Video Display Terminals. A video type work work station 
Cterminalt) such as the T0820 anc TD830 terminal devices. 
WAITING SCHEDULE: 
Contains the names and run tige aveributes of jobs ‘that are 
kaiting to be placed into the Active Schedule. 
£1P 


A method by which a program such as SYCOM» communicates with 
the MCP for certain sndecific MCP functions. 


ACRONYNS 


ACU = Auto Call Unit 
AP. =~ Application Progras 


ASCII - American Standarc Code for Information 
ner Cnenae 


BCC os Block ‘Check Character 
Bos - Beginning Of Job 
pi - Bits Per Second 

D/S - OData Set 

DOD - Direct Distance Digling 
dp~id = Disk Pack IDentifier 

EQJ = End Of Job 

I/O = Input/OQutout © 


{sn = Logical Station Nugber 
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NCP - Master Control Program 
NC - Network Controller 

NOL = . Network Definitior Language 

NIF = Network Informatior File 

00T - Operator's Display Terminat 
RJE - Remote Job Entry 

RSN - Relative Station Nueber 

SMCS - Supervisory Message Control Systea 

SOG ~- Software iperacionst Guide 
SYCOM = Systems Communications Module 

udi = Unit Device Idertifier 


VDT - Video Display Terasiral 
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TERM = DEFINITION 


goI: | | 
The currently accepted term for the 81800/B1709 systems* 
"Qperator Display Terminat™ (Cusuatty a video display 
terminal). Usage in this docusert will be the abbreviation 
"User ODT". 


QEFLINE: 
There are two facets to this tere for the SYCOM system, 1) 
2 system is “offline™ when no communications tink currently 


exists between it and a host system» and 2) a system? 
terminal» ODT» or program is “offline” when it is not 
logicaittly cannected 1! to an anglication program in a_-= host 
system. a | 

ONLINE: 

There are two meanings for his. term in a SYCOM system? 1) 


a system is “ontine™ when a cos@unications link currently 
exists between it and a host system that provides processing 
-servicess» ard 2) a terminal» OCT» or program in a User 
System is 1 “oantline™ when it is Logically connected te an 
zpplication program in a host system. (The system must be 
cnline in order for a tersirat»s ODT» or program to he 
cnltine.) | . 


Message Control Systea CSMCS) which allows it to 
“narticicete™ ir alt inout/cutput message traffic between 
the Network Controller and an application oprogran. In 
reference to a SYCOM system» the SMCS is not permitted to 
rarticipate in SYCOM*s message traffic. 


PASSWORD? | a | 
A unique string of characters that a programe coaputer 
computer operators or termiral user must supply to meet 


security requirements before gaining access to data/files. 
The password is confidential as opposed to the “"*usercode* 
which is not. es . 


POINISTO“POINT CONNECTION: 

This is € configuration tin whick a network connection is 
established hetween two>p arc only two» computers. The 
connection may include a switching facility. 


PRIVATE LINE: 
This would be a data comaurnications line which has been 
furnished to the user for exclusive usee. 
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GCUTPUT AND ERROR MESSAGES 


GENERAL 


There are three basic types of output and errcr messages produced 
by the SYCOM system and its associated system software. These 
messages are tlistec in their order cf presentation and identify 
the basic reasons for the occurrence of these messages? | 

1. Master Contrcl Program Messeges 

2. Network Controtter Messages 


2.2 SYCOM Error Messages 


MASTER CONTROL PROGRAM MESSAGES 


The Master Control Program displays saessagqes in response to a 
contrel instruction or to inform the system operator of events 
that have or ere te take place. ALL MCP output messages start in 


position 2 of the console printer/display. Refer to the 
B1800/81700 Systems System Software Cperational Guide for further 
information regarding these messaqese 


NETWORK CONTROLLER ERROR MESSAGES 


Messages displayed by the Network Controller on the system ODOT 
generzlly describe error conditions encountered during normat 
system operations. The actual cutput wessages are displayed 
starting in pesition 2 and have the fcllowing format: 


<Network Controtter name> =<job number> <message text> 


The fellowing error messages that can occur white the Controtter 
4S executing are tisted in alphabetical order and explained as 
follows 


#RETRIES UP ON LINE <nuaber> 

The retry limit is exhausted for the current message without 
teing acknowledged by the receiying syste. The "<number>* 
represents the data communicaticrs Line number as defined jn 
the Network Controller. 


MESSAGE RECEIVED FOR INVALID ADORESS 
A message has been received with an address other than "00> 
"O11", "O2"%» "O3"s» or "04". The sessage is discarded. 
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MESSAGE RECEIVED FROM DISABLED STATION <tsn> 

A message has been received for a statior that there is no 
fore room left to store the cutgoing ftessage. The <tsn> 
represents the station's Logical Station Number as defined 
in the Network Controller. The essage is discarded. 


SYCOM ERROR MESSAGES 
During command processing various errors may accurs the response 
error messages and their meanings are shown tCelow. There’ are 
tive classes of these error messages: 

« Command Informational/Error Messages 

« System Parameter Error Messages 

- System Error Messages 

- System Condition Messages 


- System Fatal Messages 


The fcllowing error message groups describe alt.messages that may 
be displayed in each of the above identified sessage classes: 


COMMAND INFORMATIONAL/ERROR NESSAGES 


The fotlowing intormational and error gwessages are displayed as 
the result of improper use of the SYCOM commands. Generally» an 
message can occur for one of three reasonss they are: 


1. A existing condition when the command is entered. 
2e- Invalid comgand syntax 
3. Invalid parameter data 


Although the reason for each nessage ts reccgrizable» there has 
been no attempt to group the wessages tnto those categories. The 
following command informational ard error messages are howevers 
alphabeticatly grouped by command to make Locating easier. 


UNRECOGNIZED COMMAND “<token>" 


This simply means that the last SYCOM command entered was 
not a valid command. 


NONW ACCEPTABLE d@<character>2 REPLACED WITH BLANK 

An unacceptable character has teen entered in a command 
string which is invalid to SYCOK. This message informs the 
user that this has occurred and has been corrected. 
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ABORT 


SYCOM CLOSING£<message>J]> CANNOT ACCEPT INPUT 
This message is returned in response to any new command 
entered “after™ an “.E0J™" cogmand is entered but prior to 
the actual shutdown of SYCOM. COnce shutdown has been 
initiated» commands are no lancer accepted.) 


THERE IS NO “PUT™ IN PROGRESS 10 ABORT 
An ABORT command was entered sith a specified option of of 
"PUT" and no file is being trarsmitted at this time. 


THERE IS NO “FETCH IN PROGRESS TO ABORT 
An ABORT coamand was entered with a specified option of of 
"FETCH™ end ro file is being received at this time. 


UNRECOGNIZED GBJECT OF “ABORT" “<token>* i 
The command was entered with an option keyword which was 
neither “PUT™ or “"FETCH™. Iry eggainese 


BUFFER 


BUFFER SIZE “<token>* EXCEEDS MAXIMUM ALLOWABLE 1950 RUN 
TIME TRANSMISSION BUFFER SIZE CHANGED TO 1950 

This simply means that the value entered for the new “huffer 
size" is unacceptable. Therefcres SYCOM not knowing the 
intention of the change» has automatically set the SUFFER 
SIZE to its faximume 


NEW BUFFER SIZE IS LESS THAN 362 RUN TIME TRANSMISSION 
BUFFER SIZE CHANGED T0 362 

This means exactly what it rezas» a value less than 7362" 
was entered as a “buffer size" gerd SYCOM automatically set 
the BUFFER SIZE to it minisue. It should be pointed out» 
howevers that this size will te unacceptable for proper 
SYCOM operations. 


CL 
UNRECOGNIZED COMMAND “CL <token>* 
The .CL command was entered either without an option or the 
cption was fourc to be invalid. 
CONNECT 


STATION ALREADY CONNECTED 

This cnly means that a “*.CONNECI™ command was entered from a 
terminal Cor ODT) that was already “cornected”™ to a Server 
System> no problem. 
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copy 


“CONNECT FAILED@: VIRTUAL TERMINAL TABLE FULL 

This message displayed indicates that all allocated "virtual 
terminal" positions are currently in usee The terminat user 
Bust try again at a later time. 


NOT DONE SINCE OFFLINE OR LOGGED OFF 

This message suggests that the request to “connect” has 
failed thecauses 1) the remote SYCOM is OFFLINE or 2). the 
user is rot properly Lagged-on toa SYCOM. 


CAN®T SCHEDULE NOWs TRY AGAIN LATER © 
The “*PUT/FETCH queue" is presently full» therefore» no more 
“PUI's* or “"FETCH*s™ can be accepted at this time. 


“REQUEST SCHEDULED WILL SEND FILE <file name> LATER 


The PUT/FETCH request was cueued to disk and will be 
processed as soon as inmprocess and prevagusly queued file 
transfers have been corsptleted. 


REQUEST SCHEDULED“"REMOTE SYCOM OFFLINE 

The PUT/FETCH requested has been queued to disk and witl be 
frocessed as soon as communications have been reestablished 
between the User and Server systems. 


"<token>" UNRECOGNIZED 


No required keyword text has been entered such as "TO"» 
“ONTO"%» or “"FROM"» =therefores what was entered in error is. 


cisplayed in this message. 


INVALID USERCODE *<token>* 

The “usercode™ entered was rejected tecause it contains 
nonwalphabetic characters. What was entered in error is 
cisplayed in the error message. 


USERCODE MAY NOT HAVE MORE THAN 17 CHARACTERS 
The length of the “usercode" entered exceeded a maximum 
elLlowable Length of 17 characters. 


SOURCE HOST ** NOT DEFINED OR REMOTE HOST “* NOT ONLINE 
An invalid *host system nase" has been specified. It is 
applicable to either the “source” or “remote” name. 


INVALID PASSWORD 

The “password™ entered was rejected because it contains 
non~alphabetic characters. This usually caused onty by 
"“lLesding" invalid characters 4s opposed to imbedded or 
trailing invalid characters. 


PASSWORD MAY NOT HAVE MORE THAN 17 CHARACTERS 
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The Length of the “password” entered exceeded a maxitum 
~llowable Length of 1/f characters. | 


INVALID FILE ATTRIBUTES <tcken> 
The command syntax keyword "US" or "USER" was expected and 
rot found in the coamand syntax. 


INVALID FILE ATTRIBUTE DELIMITER? “<token>* 
The "COPY" syntax requires a cosma “»”" between the attribute 
"<usercode>”™ and the perenne "PASSWORD". 


FILE NAME MISSING 
The command syntax requires a “file name™ specified for a 
file transfers it was either nat given or recognized. 


KIND DEFINED TWICE fi 
The “"KINO™ option keyword has been previously. specified in 
the commend Sean: 


INVALID KIND ATTRIBUTE *™<token>* 
The kind option keyword was not “PACK™s» “PETAPE"%» “TAPE"» 
"TAPES*™» cr “TAPES” which makes what was entered invalid. 


INVALID HOST NAME 
The host system name entereac was rejected because it 
contained nonvalphabetic charéecters. This message could 
apply to either the “scurce™ or “remote™ host name. 


HOST NAME HAS MORE THAN 17 CHARACTERS 

When a host system name is entered with more than 17 
characters Cmaximum allowable). This message could apply to 
either the “source™ or *remote™ host names 


UNRECOGNIZABLE VOLUME ATTRIBUTE “<token>* 

This message is somewhat misleacing in that it is only) an 
indication that a keyword of “KIND™ or “HOST™ was expected 
end rot fcund.e 


MISSING “»* BETWEEN VOLUME ATTRIBUTES 

An attribute separator character cf “»" is required by the 
coemand syntax to indicate the end of the attribute “KIND*" 
and its associated ontion keyuwore. It is not there and it 
is wantede 


VOLUME NAME HAS MORE THAN 17 CHARACTERS 

The “volume name" Cor pack~id) ertered exceeded the maximua 
allowable Length of 17 characters. This message could 
relate tc either *voluwe"1" oar “*vyclume-2" ramese 


INVALID SOURCE HOST NAME “<token>* 

The system identifier specified as -a “saurce host™ does not 
match the “"Local™ system name» the “remote” system nameer and 
is not blanks. The request is rect processed. 
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FILE <file name> NOT OPENED £1] OUTPUT PACK NOT FOUND 

During SYCOM"s file openwon-behalf-of processing»s the MCP 
returns a value for the last counmunicate issued. This value 
indicates that the requirec destination pack is not 
currently ontine. 


FILE <file name> NOT OPENED €4) INVALIO USERCODE/PASSWORD 
The MCP has informed SYCOM that the openton~behal f-oft 
request has heen rejected because the Usercode/Password 
combinaticn used was found to te invalid. 


FILE <file name> NOT FOUND €1) INPUT FILE MESSING 
The object file for a PUT file transfer was not found in the 
cisk directory Cdisk) or was not canline (tape or disk pack). 


FILE <file naage> NOT FOUND €2] FILE LOCKED 

The MCP has informed SYCOM that the open~on~behal f~of 
request has been rejected because the target file is 
currently “locked*. 


FILE <file name> NOT FOUND €33 NO USERCODE FILE 

The WCP has informed SYCOM that the open-on-behal f-of 
request has teen rejected because the CSYSTEM)/USERCODE file 
coes not exists it is required. 


FILE <file name> NOT FOUND €4] INVALID USERCODE/PASSWORD 

The MCP has informed SYCOM that the open-on-behal f-of 
request has been rejected because the Usercode/Password 
coebination used was found to te invalid. 


FILE <file name> NOT FOUND C5] VIOLATES USERCODE CONVENTION 
The MCP has informed SYCQM that the open-on-behal f-of 
request has beer rejected because the Usercode/Password 
combination entered is not priviltegeds as required. 


FILE <file name> NOT FOUND €6] SECURITY TYPE ERROR 

The MCP has informed SYCOM that the open-on~behal f-of 
request has been rejected because no Usercode/Password was 
entered when it 1s required. 


FILE <file name> NOY FOUND £71] SECURITY USE ERROR 

The MCP has inforsed SYCOM that the open-on~behal f-of 
request has been rejected because a hops peleteded user is 
trying to access a privileged file. 


FILE <file name> NOT FOUND €8] EXECUTE ONLY FILE 

The fite requested for transfer is flacged by the MCP as a 
non™accessible file for internzt execution only and the 
request has been rejected for that reasor.e 


FILE <file name> NOT OPENED €9] WOULD BE DISCARDED 

The MCP would discard the file at the end of transmission 
Ceeg. attempt to create a non usercoded file by a 
ron-privileged user). 
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FILE <file name> LOCKED 


The object file for a4 PUT file transfer was found to be 
"Locked™ in the disk directory (cisk). 


FILE <file name> FILE TYPE CANNOT BE TRANSMITTED 
The disk file specified for file transfer is not one of the 
file types which SYCOM can transfer. 


SOURCE OR DESTINATION. FILE NAME MISSING 

This message indicates that a subject file name was missing 
frome the command string which was entered as either a 
“COPY™s>» “PUT"» or "FETCH" from gnother system. 


SOURCE OR DESTINATION FILE NAME “<token>* INVALID 

The specified file name was found to contain characters 
cther thén those which are ccrsidered valid for a fite 
identifier? or» a multi-file icentifier was indicated ("/") 
but was net included. 


FILE NAME WAS IDENTIFIED WITH MORE THAN 10 CHARACTERS | 


The name of the file to be transgitted was found to contain 
an identifier in excess of 10 characters. Tts the maxiaua 


ellowabte. 


CANNOT LIST THIS FILE - NOT A BACKUP FILE 

A file wes received from another system and was flagged for 
“auto print". | This message explains the reason for not 
coing it and would correspond tc the “<file name> RECEIVED? 
COT message. 


FILE <file name> ALREADY EXISTS AT DESTINATION ~ PUT ABORTED 
Hhen SYCOM is setting up to “receive” a disk Cor pack) file>» 

ait checks to disk directory. If the specified file atready 
exists» this message is displayed and the transfer is 
zebortede. 


FILE FAMILY NOT ALLOWED 


As suspected» in the specified file names an equal sign 
("=") was found which represented either a “pack-id”™» 
*multi~filetid". This is illegals the file named must be 


specific. 


DEBUG 


CEBUG ALREADY ON 


The command was entered to turn DEBUG “O0ON" which was 
currently on. 
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DEBUG WAS ALREADY OFF 


The co@mmand was entered to tern OEBUG “OFF" which was 
currently off. 


ERROR - “ON" OR “OFF" OR “DUMP EXPECTED 
The option keyword entered with the DEBUG command is not 
valid. Please try again. 


DISCONNECT 


EQJ 


STATION ALREADY DISCONNECTED . 
This only @eans that a “DISCONNECT™ message was entered from 
a terminal that was already disconnected* it was ignored. 


STOP OR WAIT IN PROGRESS 
This means that a “eWAIT™ command has been entered and SYCOM 


is responding to that requests the “.eE0J"™ command ts 
ignored. 


FETCH Calso see COPY) 


LIST 


CANNOT FETCH WHEN REMOTE SYCOM OFFLINE 


This message is indication that = an inter-system line 
connection dces not presently exist and the “FETCH* request 
cannot be accomsodated.- 


SOURCE OR HOST NAMES MAY NOT BE DEFINED IN A FETCH 
Lse of the shorthand versior CFETCH) of the COPY command 


iaplies the source and destination systemse thereforers they 
Cannot be specified. 


FILE <file name> IN USE AT DESTINATION““FETCH ABORTED 

The file in question was received and when atteapting to 
close it (which removes any existing file copy)» finds that 
the file to be replaceo is currently in use. The FETCH is 


aborted and the received file is losts> it must be requested 
againe 


UNRECOGNIZED OPERAND “<token>* 


This siteaply means that an inccrrect or misspelted option 
keyword was entereds and rejectea. 
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The command was entered without any keyword options. 


FEMCTE SYCOM IS OFFLINE] LAST COUNT OF FETCHES MAS Q 
This messeae is self explanatory. . 


OFFLINE 


STOP OR WAIT IN PROGRESS 

This message indicates that SYCOM is in the process of 
servicing a “seHAIT"™ command which in effect produces an 
“offline™ conditions the ".-OGFFLINE™ coawand is ignored. 


PHONE 


INVALID PHONE NO 


This message is returned wher the phone number” entered 
contains atphabetic characters. 


ONE NUMBER TCO LONG 


PHON | 
This message is returned wher the phone nuaber entered 
contains sore than 20 digits Circluding hynhens). 


PHONE NUMEER REJECTED BY NC “<phone nusber>* 


The Network Controller has rejected the request by SYCOM to 
change the existing “phone nusber™ to the one entered> no 
reason wes specified for the rejection. . 


PUT Calsa see COPY) 


CANNOT PUT WHEN REMOTE SYCOM OFFLINE | 
This message means that an interesyste# connection does no 
presently exist» therefore» a “PUT™ cannot be done. The 


request» howevers is saved ir the “"PUTQUEUVE" for tater 
transmission. 


SOURCE OR DESTUNATION HOST NAMES MAY NOT BE DEFINED IN PUT 


Lse of the shorthand versicr CPUTY of the COPY cosnmand 
implies the source and destination systems» therefore» they 
cannot be specified in the commend string. 


PUT OF FILE <file nase> ABORTED 
This message occurs when SYCOM is attempting to “send” a 
file to the other system and the specified file is currently 
in use cr that system. The PUT is aborted. 


QS 


ERRORS “.QS" OPERAND NOT NUMERIC 
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The *%-G5S" command is entered nith a non numeric queue size 


integer field and was ignored. It is necessary to re~enter 
the command string in correct fcrmat. 


ERRORS °OS" OPERAND MAY NOT EXCEED 15 

The queue size integer entered was greater than 15 and was 
summarily rejected. It must be re-entered with an 
appropriate integer value. 


ERROR “OS® GPERAND MUST BE AT LEAST 4 


The queue size integer entered was less than the value 4 and 
vas rejected. The command e#ust be rertentered with a 
legitimate integer value. 


READ 
REQUEST IGNORED: ‘CARD FILE STILL OPEN : 
This message is displayed if a ".READ™ command is entered 
when an input card file is currently active. The entire 
command string is rejected arc ciscarded. 
REQUEST IGNOREDS NOT LOGGED ON 
This message could mean the carc reader is not ready. 
FILE *<file-nase>* WOT PRESENT» TRY AGAIN 
The command “.READ™ was entered and the card or disk file 
"<file-name>" is not presente 

RESTART 
11 consecutive timeouts. Resote SYCOM presumed “OFFLIWE™ AT 
08222:29.1 ON 16 AUG 79 
This is a direct indication that the remote system is not 
responding to the tocal SYCOM procedures and is considered 
to be in an OFFLINE state. 

RY 
UNRECOGNIZED COMMAND "RY <token>* 
The command string containec an =unrecognizable option 
keywords not "CP%» "LP™» or "CR". . 

SIZE 


ERRORS “.SIZE" OPERAND NOT NUMERIC 
The integer entered with the cossand string was comprised of 


~t teast one non digit character. The integer must be atl 
digits» no excertions. 


ERRORS “.eSIZE" CANNOT EXCEED 400 
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STOP 


SV 


wot ee ee ee 


USER 


This message 1s displayed wnen &€ size integer is entered 
which exceeds the Maxitum message block size established for 
the systems four hundred €4C0) tytes. 


ERRORS “.SIZE* CANNOT BE LESS THAN 78 

This message is displayed when the size integer entered is 
less then the minimum allcwable message block size; for 
this system the minimut? size is 7& bytes. 


This command cannot directly cause an error message. 


UNRECOGNIZED COMMAND “SV <token>® 
The «SV command was entered either without an option or’ the 
cption entered was found to te irvalid Cnot “LP™ or "CP*). 


CISK TRACE ALREADY ON 


The command was entered te turr tracing “ON™ and SYCOM was 
zglready in trace mode. 


DISK TRACE WAS ALREADY OFF 


The command was entered to turn tracing “OFF” and SYCOM was 
not currently itn trace modee 


ERROR ~- “ON* OR “OFF* EXPECTED 
The cnly valid options to the TRACE command are “ON"» "OFF" 
cr no option specified. 


INVALID USERCODE “<token>* 
The usercode used to logton with was found to contain 
t 


i. 


n correct 


laaran 


cigits. Lease tcg-off and togron again wi 
usercode/password eseninatien: 


INVALID PASSWORD *<token>* 

The password which the user sitcned"on with was found to 
contain digits. Please tloaroff and logon again with a 
legitimate usercode/password ccabination. 


CANNOT SIGN ON IN 8.0 INDIRECT MODE. PROTOCOL 2 WILL USE 
USERCODE/PASSWORD FROM SMCS IF SIGNED ON 

The user attempted to PASS "seus usercode/password™ to SYCOM 
without LCeing “Logged on” to the SMCS. 
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SYSIEN PARAMETER ERROR MESSAGES 


The following error messages could occur during the parameters 
input processe The problem indicated applies to both ODT input 
as wetl as card input. In either case» SYCOM must be DS'd» the 
problea{s) corrected» and the parameters reentered as required. 


INVALID PARAMETERS “<token>* 


This message is displayed when the parameter keyword entered 
cid rot watch one of the acceptable keywords. 


*=* EXPECTED BUT GOT *<token>* 


A parameter was entered with a value which must be separated 
ty the equal C=) character. 


INTEGER EXPECTED BUT GOT “<token>® 7 

The .BUFFER and RECORD parameters require an integer which 
specifies the BUFFER/RECORD size in bytes. As this is not 
what was entered» what was founc is included in the message. 


BUFFER SIZE “<token>" EXCEEDS MAXIMUM ALLOWABLE 1950 
The maximua allowable BUFFER size is pene ny aes What was 
specified exceeded this Limit. 


INVALID SYSTEM ID “<token>* T00 LONG 

The “system id" entered has either exceeded the parameter 
size limit of 17 bytes» it was excluded altogether» or 
special characters have been detected. 


INVALID PARAMETERS FILE> BEING REMOVED 

This message occurs when the “PARAMETERS™ file is opened» 
the parameters read in» and the version is incorrect or the 
“maximum tuffer size" was found tc exceed the system maximum 
cf 1950 bytes. When this ccndition is encountered» the 
"SYCOM/PARAMETERS* file is remcved and new parameters must 
te entered. | 


SYSTE® WARNING MESSAGES 


Warning messages displayed on the User ODT indicate a problem at 
the system level. They have been rectified by SYCOM so that 
operations can continue without operétor intervention. They are 
hot generally considered to be major cr extensive in nature = and 
therefore» SYCOQM has elected to take iasediate corrective action. 


8## WARNING ~- REMOTE HOST NAME SAME AS LOCAL SYSTEM ID. 

This probles its resolved by stopping SYCOM and re~creating 
the “SYCCM/PARAMETERS" file with an appropriate “SYSTEMID* 
change or using sSYSTEMID cosmarcd. 


INQ OVERFLOW> FOLLOWING MSG DISCARDED <60 or less characters 
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of message> 

- If during a Write to a Progr am-to~SYCOM application proaran 
en "inccmplete-i/o™ cccurse this message is displayed to 
provide the warning for thts ccrdition. 


TERMINALS FILE OVERFLOW> MESSAGE DISCARDED <60 or tess 
characters of msessage> | 

If during a message Write to the remote file TERMINALS an 
"“incorplete-i/o" occurs» the above message is displayed to 
inform the system operator of this condition. 


INCOMPLETE I0 GN LINK FILE IGNORED 

OR | _ 

INCOMPLETE I0 ON TERMINALS FILE IGNORED 
OR | | 


INCOMPLETE IC ON auTa FILE IGNORED 
The comptlex-wait has interrupted SYCO™M for either the LINK» 
TERMINALS» or QUTA file anc the Result Descriptor indicates 


Ee a z : 
an “incosplete 7/0" has oaccurrece This error is Logged and 


fa 
SYCOM reverts back to “wait™ moce. 


LINK QUEUE OVERFLOWs MESSAGE DISCARDED 

The queue "LINK.»G" is full» therefore» ro more messages can 
be queued at this time. The wessage in question is dumped 
es there is nothing SYCUM car dc with ite 


NUMBER OF TIMEQUTS = <nueber> 
This message is displayed autosaticaltty when “timeouts” keep 


reoccurring on the interwsystem Lire connection. It is 
only output on an incremental basis (Cn) to reduce ODT 


activity> — where <n> 1s specified in the “JIMEQUTS" 
Carareter. 


LOSS OF DATA-SET-READY 

Cisplay of this message occurs each time the indicated event 
is detectede A count is maintained of these occurrences and 
£YCOM goes into the state of “iritialization"™. In progress 
file transfers are aborted and toste If this continuously 
cccurs at BOJ» the adapter may te incorrectly strapped. 


HOST SYSTEM CARD READER HALTED 
When this message occurs it 1s to inform the system operator 
of < condition that presently exists on the remote system. 


HOST SYSTEM CARD READER ABORTED 

This message is used to inform the system operator that card 
reader input from the remote system has been aborted. No 
éction is required of the operatcr. 


HOST SYSTEM CARD READER READY 
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A message that is used to infcrm the local systea operator 
that card input from the remote system has resumed. 


SYCOM WILL CLOSE WHEN NEXT IDLE 
The “ENDJ" command has been enterec and SYCOM is processing 
creviously entered requests. hhen these requests have been 
rrocesseds» SYCOM will terminate. 


4@ SPURIOUS .~CONNECT IGNORED #8 . 
This meaning is clears SYCOM was interrupted with an 
unknown “conrect™ message which it tgnored. 


@# SPURIOUS ~DISCONNECT IGNORED #8 
The meaning of this message 1s clear> SYCOM was interrupted 
with an unknown “agisconnect™ message which it tgnored. 


SYCOM CLOSING ON REQUEST FROM REMOTE SYCOM 

The remote SYCOM program has been directed to go to “EQJ™ by 
the entry of either "EQJ”" or "STOP" from that system. When 
this occurs» it sends a control type message to the other 
SYCO¥ which causes the above message to te displayed. 


ERRORS MESSAGE TYPE = <type code> 

An input message from the remote file "LINK" was found to be 
invalid. The message type code is included in the displayed 
error message for reference. 


REMOTE SYCOM HAS GONE DOWN AND COME BACK UP 

This message is self explanatory in that for some reason the 
remote SYCOM disconnected the tire and then reestablished 
com@aunicstion with this SYCOM resulting in the above message 
being displayed on the system CCT. 


CUEUE RJEQ FULL» MESSAGE DISCARDED | 
The queue “RJE-Q" is full» therefore» no more messages can 
be queued to it and the current sessage is discarded. 


&#8@ WARNING - NO “SYSTEMID™ #82 

Upon coapletion of the accept SYCOM parameters processes it 
was determined that a “system-ic"™ has not been specified 
Ceither rot entered or was ir error). 


SYSTE® CONDITION MESSAGES 


Any of the following messages displzyed on the User ODT indicate 
an abroraat system condition of some type. As a rule» when one 
of these conditions is encountered» the display of an appropriate 
message also elicits a response fros the system operator. 


CARD PUNCH EXCEPTION PLEASE ENTER “.RY CP* WHEN DEVICE IS 
FEADY OR “-SV CP" TO SAWE THE FILE 
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This message is displayed when SYCOM is attempting to punch 
a card and an “exception" condition is encountered. 
€Ceneratly this indicates that the card punch has gone “not 
ready” for any one of Several reasons. It is necessary to 
respond to SYCCM with the apgercpriate command when action 
has been taken to ready the unit. 


LINE PRINTER EXCEPTION PLEASE ENTER @ RY Lpe WHEN DEVICE 1S 
FEADY OR *.SV LP™ TQ SAWE THE FILE 
This message is displayed when SYCOM is attempting to print 


é tine and an “exception™ condition 1s encountered. 
Generaily this indicates that the line printer has gone “not 
ready” fer any one of several rezsons. It is necessary to 
respond to SYCOM with the apgercpriate command when action 
has been taken to ready the unite | 


PARITY ERROR ON READ PLEASE READ LAST CARD AGAIN 

This messége is displayed when SYCOM is attempting to read 
the card file and an “exception” condition is encountered. 
Cenerally this irdicates that tte card reader has gone “not 
ready™ for any one of several reasons. It is necessary to 
respond tc SYCOM with the approgriate command when action 
has been taken to ready the unit. 

<message text>: BAD LSN = <sessage tsn> . 

Khen writing a reply message to a terminal» an "EOF" status 
was encountered and SYCOM assusged that an invalid “"lsn" was 
the cause.s Therefore» that messzge text is displayed on the 
System OfCT as part cf the above sessage. No further action 
1s taken on the part of SYCO*M. 


<message text>: INVALID LSN = <message Lsn> 

When writing a reply message to a terminal» an "EOF" status 
was encountered and SYCOM assumed that an invalid "lsn™ was 
the cause. Therefore» that wressage text is displayed on the 
System OCT as part of the above wessage. No further action 
has been taken by SYCOM in this matter. 


PUNCH ERROR 

The card punch has either detectec an error in the last card 
funched or has degraded into a “not ready” states In either 
cases é “suspend* contrei sessage has been sent to the 
Server Systeme . 
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READER ERROR 
The card reader has either cetected an error in the last 
card read» gone into a “not reagy™ state» or has detected an 


invalid character in‘a card colusns other than coluan 1. 
If there was a fread errors tte tast card must be put back 
into the card hopper. The card reader is then made 


thysically "“ready"s all cases. SYCOM must then be informed 
of this mew status condition with the entry of a “.»READY® 
commande . 


PRINTER ERROR 

The Line printer has either cetected an error on the last 
line printed or has agone into a “not ready” state. In both 
cases a “suspend” coantrol message is sent to the Server 
Systeme when everything 18 again ready with the printers a 
",READY™ command must he enterec to inform SYCOM. 


CARD READER CLOSED 


This simply means the card input has been completed and the 
card file closed. 


CC INITIATED | 

In doing a read on the remote file “LINK™ an "EOF™ condition 
nas detected. This conditicr is caused by the MCP when a 
"Qc" command is entered, whict shuts down att programs 
associated with the Network Controtler. 


NO PHONE NUMBER 
This is. indication that wher attempting to establish 
cowmunications with another system» SYCOM determined “auto 


dialeup™ was necessary but the required phone number is not 
present. 


INVALID CONTROL MESSAGE RECEIVED = <message text> 

khen SYCOQM receives a system “centrol sessage” from a remote 
System anc the “type code” in this messace is not within the 
CO ~ 23 number ranger then the above message is displayed. 
The input message is discarded and no further processing is 
done on its behalf. 


BUG IN NETWORK CONTROLLER. WIT INDEX = <vtt> I.E. STATION 

WAS NOT CONNECTED OR WRONG LSN IN CLOSE MESSAGE. . 

A “close” message has been received frow tne system Network 

Controtler for a prograa known to SYCOM which contained a 

"tsn tlist”. This tist ircluced a Virtual Terminat Table 

Index CVTT INDEX) entry for a terminal not signed-on to that 
“programs thus the reason for this message. 


REMOTE SYCOM TERMINATED 
This message indicates that the communications tink between 
the two systems has been interrupted for some reason. SYCOM 


will attempt to reestablish the connection and failing that 
reverts to "Cffline Standby” msoce. : 
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SYSTEM FATAL MESSAGES 


These messages are cof the type whick prectude the automatic shut 
down of SYCC#. There are considered “fatal” in the outlook of 
continuing operations and therefcres» SYCOM is shut downe 


FATAL ERROR AT <progeasg sequence number> <sessage> 

The display of this message cn the User OPT could be_ the 
result of any number of reasonse The SYCOM source sequence 
rumber displayeac is the only clue to the _ problem. SYCOM 
initiates a “Listvwdisk"trace™ anda "*@emory dump” at this 
and automaticatly goes to EQ. after certain disconnect 
functions have been satisfied. 


REMOTE VERSION OF SYCOM Is INCOMPATIBLE HIS 
VERSION="<version nurgber>*s»s MINE="02° 

This message identifies the rrotlem at hand. SYCOM goes to 
EQJ immediately at this point. This version is determined 
ty the SCS. 


ANOTHER SYCOM WITH SAME MULTI“FILE-ID IS RUNNING 

Tne display of this message indicates that SYCOM cannot gain 
eccess te the “SYCOM/PUT.-QUELE"™ file (Con disk) as it is 
rresently in use by another procrag. | 


REMOVE PUT-QUEUE OR CHANGE ITS NAME IF 7-0 FILE 
If the disk file by that nase is Less than 99 records» when 
reading it» SYCOM will get an “EQF™ and aborts immediatety. 
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APPENDIX Bs CHARACTER SET 


The following graphic character set cefines those characters that 
are acceptable to SYCOM as inpute Threse characters can be in the 
tore cf cermiral input/outout messages» data files or intersystes 
contrcl messacese Other characters incountered by SYCOM will he 
dealt with as per the established “file transfer” rules. 


The graphic character set is arranged in “rows” by the internal 
colléeting sequence with “blank” being lowest and "9" high: 


blark f ° < C + 1 & ] $ * ) , 
2 - / a ’ z a > 2 : t q ' 
= " a b c d e f g h 1 j k 
l r n 0 p q r S t u Vv ) x 
y z A B Cc D E F G H I J K 
L M N 0 P Q R \ S T U Vv W 
X Y Z 0 1 2 3 4 5 6 7 8 9 


It is recommended that the standard “signal character" of *." be 
retatred by the SYCOM for use as a Iccat SYCOM message switching 
characters However» if this is not suitable for any reasons one 
the fcllowing speciet characters is suggested: (CA very important | 
point ta note is that when chanjzing SYCOM's “signal character”, 
do assign a character which conflicts with the system"’s current 
"SMCS signal character".) | 


{f & $ % 1 # a + 


Speciel data communications characters recognized by SYCOM are: 


SCH EOQT OLE ENQ STK ETX FS FS 
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APPENDIX Cz COMMARD SUMMARY 


The fcllowing coamand summary List is presented in atphabetical 


server System. 


sequerce for easy reference. Refer to the command descriptions 
for ccamand syntax and ontian details. 

1 COMMAND 1 STATION 1 FUNCTION 

i sama ee eae Bene RDB TOOT eee DSB He TBE HB DSASTBMaeF ean BwTaeVswsa Qeaens Hs waananaanwaaese 
j I 1 ye fs 

1ABORT ] any 1 Abort a PUT or FETCH file transfer. — 

1 j 1 4s a . 

LADD i any. 1 Transfer 2 file if it does not already 

| 1 $ exist et the destiration 

j j | . 

IBUFFER 1 any co 1! Query or change transmission block size. 
i ! 1 _ | 

iBYE 1 any 1 Station tcenoff from SYCOM. 

H } { 

ICL I ODT I Clear peripheral device. 

1 J 1 . . 

ICONNECT j any i} Reaquest establishment of a terminal to a 
I | {i Server Syste. 

{ ] 1 . | 
ICCPY | any 1 Transfer z~ file Cregardless of whether 

| I 1 or not it extsts at the destination) 

i j : i 

ice i ODT | Informs SYCOM of “not ready” peripheral. 
| | ! 

IDEBLE i any q ! Start/stcp input/output message tracinge 
~ ' 4 
IDISCCNNECT ! any ! Request fer terminal disconnection from 
1 1 I the Server System. 

IEOJ j oOoT ! Cause SYCCM into an orderly shutdown. 

| | | : 

{FETCH | any 1 File trarsfers Cfetch from other system) 
i I ] 

iGROUFSIZE i any q i Set or interrogate group size for 

I ! |! transfers of families fo files 

i i 1 

ILIST { any § Display selective system information. 

| ! I 

{LaG { any q 1! Oisplay a List of data comm error coynts 
| ! ! and orcgrasr statistics 

1 | I 

ILP 1 OOT ! Inform SYCCM Line printer "not ready”. 

! ! i 

FOFFLINE I CDT 1 Cause SYCCM to break the connection to a 
! { ! | 

| ! I 
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ONLINE 1 OOT 
i i 
IPHONE J any a 
t ( 
i P | 
IPROGRAM i any a 
] 1 
IPUT 1 any 
i | 
10S { ODT a 
! j 
! t 
IREAC j OoOT 
J 

TRESTART | ODT 
i. 4 
IRY 1 ODT 
i i 
'SIGNAL 1 any 
i { 
a t 
ISIZE i any @Q 
1 1 
1STOP ] OoT 
] | 
'Sv ] ODT 
| a. A 
ISYSTEMID | any a 

ae | 
] 1 
ITRACE i any c 
t 1 . 
PUSER i any 
1 i 
IWAIT J any q 
I ! 
I i 
TWHAT 1 any 
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Establish a Server System connections 


Establish or clear phone number. 


Server System. 
queue or change program parameter 
File transfers Cput to other system). 


Query or change Network Controller queue 
depth sizee 


Open ara transmit card input file. 


Disconnect lines initialize and standby. 


Inform SYCOM of availabie peripheral. 


Query or change SYCOM station's pseudo 
signal“character. 


Change saxigum message block size. 
Cause SYCOM to shutdcwn immediately. 
Stop transeitting and "save" file. 


Interrogate or charge value of SYSTEMID 
parameter 


Start/Stop SYCOM I/O disk tracing. 


Log a user onto SYCOM. 


errs or change value of WAIT 


Narameter 


SYCUM status inquiry. 
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APPENDIX Ds SYNTACTICAL KEYWORD SUMMARY 


Syntacticat keywords will be reccgnized by SYCOM when they appear 
within specific context within the command string syntax. Should 
a snecified "file name" happen to match one cf these “keywords”» 
go net worrys for this is a perfectly acceptable use of a keyword 
outside of the command syntactical ccertexte A complete summary 
of these keywords follows: te 


AS BINARY ss CLEAR cp | €R 

DISK DUMP. FETCH FROM HOST 
KIND LIST LP NO NR 

OFF OLDTRACE ON ONTC | PACK 
PARAMETERS PASSWORD PETAPE PUT PUTQUEUE 
REMOVE SAVE SCHEDULE TAPE TAPE7 
TAPES TERMINALS TO | TRACE US 


USER USERS 
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APPENDIX E2 COMMUNICATIONS CONTROL MESSAGES 


GENERAL 


As there are several message fermets used for inter-SYCOM data 
comsunications» each format is specified in detail. These 
message formats are presented ir 4 seauence dictated by the 
messace type code. A list of messace types are shown below» 
followed by individual message format cescriptions. 


ad 


MESSAGE TYPES 


The message type codes are derivatives from the "DA1™/"DA2" 
(Device Address) fieid. The message type codes apply to message 
trans#issions in either ditrectior and are compatible between 
system types. Following then are the device address conventions 
used cy SYCOMs alt cther values are ccensidered invalid: 


{ DA1 ! CA2 { Usage I 
1 wea evn wwa ener ater asa awawananaenanwaawseaan a ese egensvwvawa2 wa aunwam ~~ on on ee oe ee ow we om ow 1 
i Oo 1 0 { System control i 
1 a | 1 ! ODI messages 1 
1 Oo $ 2 { Card reader/punch data wsessages ! 
i Oo } 3 | Line printer data messages t 
i | 4 Yo File transfer cata messages | 
j 1 1 . 1 
i ‘| 2 ! Packed card purch data sessages 1 
! 1 1 { 
i a ! A 1 User System “transmit*» Server System 1 
1 thru 1 “"receive™s» virtuat terminal nmessages ! 
i z | Z ! \ 
1 , | 
I A} a 1 User System "receive™s Server System 1 
1 thru 1 "transmit*» virtual terriral messages 1! 
H z z H . i 
Device addresses are advisory only. The receiving systea can 


direct a message to any appropriate peripheral device» based on 
its ckn requiremertse 


Note: Line printer data is allowed in both directions. When a 
system receives line printer catas it can print it on any 
available printers independertly of whether the system is 
termed a User System or a Server Syste. 
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MESSAGE FORMATS 


BASIC DATA COMMUNICATION MESSAGES 


As per the line protocols the belcw sessage format adheres to the 
criteria of standard RJE message forratting: 


SATSDD EB 
ORMTAACK--=----- = TEXT c----+--- > TC 
HM#X12 XC 


The individual characters in this message function as follows: 


Ae SGH - This is the standérd ASCII character which is 
used to indicate data transmission as opposed to 
connection establishment communication. 


EB. ARM - The . “Acknowledge Keceived Message” character 
which ts used to accept or reject the last message 
block received. 


C. TMZ - The “Transmission Nusber"™ character used in the 
ackrowledgewent of a messagee It represents one of two 
values Calternating characters) selected for 
isaplementation by SYCOM. #$=The characters "5" and %&* 


are used by the User System SYCOM whereas” the 
characters "F™ and "U" are used by the Server Syster 
SYCCKM. 


Ce STX ~- A standard control character used to delimit the 
preceding header characters from the message. 


Ee DA1/CA2 - Two characters representing a "Device 
Address” value. 


Fe TEXT - The message text field usually containing data 
(record images or a messagé)e 


C. ETX - The standard “end-of-text" control character. 


K. BCC - A Block Check Character which is comprised of a 
Longitudinal parity bit corfiguraticn that is used» by 
the hardwares to verify that the message has_ been 
received correctly. 


SYSTE¥ CONTROL MESSAGE 


Systems control messages are used to excharge control type data 
between systems. A complete descrirftive List foilows the message 
format which is a variation of the basic message format: 
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SATSDDCC . EB 

ORMTAADD<---- variables Ctext) ce-->TC 

HM #X1212 | | xc 

"Qo" 

Here we have the addition of the "CL1I*/"CD2" characters. These 
two characters represent the system sessage “type” code; which 


may or may not be followed by variable control data. 


ODOT MESSAGES 


The CDT Message format uses the basic format without alteration. 
There are no provisions for blocking CDT Messages» therefores the 
rule is? one ODT Message per certrctl message block. The format 
of this type message is as follows: 


SATSDD EB 

ORMTAAS oma ---- 2 TEXT serse-- =->TC 

HM #X12 xc 
Foi" 


CARD FEADER/PUNCH MESSAGE 


The format for card reader/punch data images is as follows: The 
"RS" CRecord Separegtor) character used between each card image 
provides the means for blocking. 


SATSDD | R EB 

ORMTAA<=-"-= card image ---->S<---- card image ---->ITC 

HM#X12 XC 
“92” 


LINE FRINTER MESSAGE | 


The following format variation is used to transmit Line Printer 
data lines between systems: 


SATSDDP | - , E8 
ORMTAAC<==-~ Line image ~~~~>S<---- Line image ~--->TC 
He BXL2C XC 


£4 
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This format is the same as the Card Reader/Punch format except 
that the “PCC™ character is utilized. The value of this fietd 
can te one of the following codes: 


PCC Function 


0 Print» no spacing 
1 Prirts single space 
2 Prints» double space 
A Skig to channel 1 (tcn of page) 
B 2 
ee ad 3 
D " 4 
IB, 3 Me 5 
F ~ 6 
G ” 7 
H - 8 
I ee 9 
oJ bad 19 
K = 11 
L ” 12 (Cbottom af page) 
H * 8 


FILE TRANSFER MESSAGE 


The File Transfer message format is glso the same as that used to 
transfer card images. Although the “PCC* character field is 
included» it is only there to maintair wsessage conformity: 


SATSOD F £8 

ORMTAA<*"-"- record data “"77">8<er-rrecord data -="->TC 

HM#X12 . xe 
"a4" 


VIRTUAL TERMINAL MESSAGE 


The #essage format utilized for virtuat terminal messages is the 
basic message format» with one excertion: the “device address® 
for é virtuelt terminal is comprisec of two Letters (1 Lowers 1 
upper “transmit”: 1 upper» 1 tower “receive"™) and will vary by 


termiral. §The format is as follows: (CTermiral and ODT messages 
are “rot™ blocked.) 
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SATSDD . EB 
DRMNTAA< S32 2523 2-5> message text ss ttt..C¢- >TC 
HM#X12 XC 


xX" (Ctransmit) 
"Xx" Creceived 


FILE SEPARATOR MESSAGES 


This message format is utitized by SYCOM when it is necessary to 
transfer a “symbolic file header“» indicate the “beginning of a 
file"™» or indicate the “erd of a file". This applies equally to 
the “Card Reader/Punch™» "Line Printer"™» and “File Transfer" 
operationse Tec accomplish this» there are three minor vartations 
to the File Transfer Message format hhich are identified with the 
fotloning message formats. 


The “Card Reacer/Punch"™» “Line Printer"»s and “File Trans fer™ 


Begin File Message 


The fcrmat for the Begin File gsessage is as follows: 


SATSDOF E®8 
ORMTAASi<“-"--~- file name ~727>TC 
HM #X12 xc 

"O02" 

"93" 

"Qa" 


End File Message 
The format for the "“erd file™ message is as follows: 
SATSDDF | ER 


ORMTAAS2<-"7 FilewNage =< >FC 
HM#X12 XC 
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PROGRAM~tO-PRCGRAM MESSAGES 


The fcllowing sessage format pertairs to SYCOM's “program=to- 
Program” facility,» thru a “Remote File: : 


REMOTE -KEY (10 characters) Z Message “header”. 


- RSN (C4) 


Z% felative Station Number for 

2 “virtual terminal” as defined 

% for the program-to-~progran 

% remote files usuatly "0001". 
- LENGTH C 4) ; Z Length of message text. 
ere C 2) % Message types usually *00". 


MESSAGE TEXT Cnn characters) 2% Maxiaus is “buffersize™. | 
“~ LENGTH C 4). Z Length of message text. 


PROGRAM@to-SYCOM MESSAGES 


SYCOM has the inherent capability to accept command strings from 
an apclication prograr and respond with reply messages thru the 
"Program-to~SYCOM"* interface facility. This facility utilizes 
the "cueue™ mechanism» whereby SYCO* reads input from the queue 
file "SYCOM/QUIOQ"™ and writes replies into the queue file 
"SYCCK/SING". (If these queue file names seem reversed»  § its 
because they are oriented tc the application program.) 
Input/Output message formats are defiired as fcltows: 


Input CSYCOM/INQ): 


Program supplied I/D 4 bytes 
Filler 6 bytes 
SYCOM command string 1940 bytes Cmaxiaum) 


1950 bytes (Cmaximun) 


Cutput CSYCOM/NUTO)S 


Program supplied I/D 4 bytes 
Keply message Length 4 bytes 
Reply message code 2 bytes 
SYCOM reply message 1940 bytes Cmaximuam) 


1950 bytes Cmaximum) 
Reply messaaq bytes 


ord 
= 
tis) 
3 
2 
“" 
> s 
ad 
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APPENDIX FS RESTRICTED NCP COMMAND SUMMARY 


ALL input commands that are prefixed with a "2?" are sent directty 
to the MCP exactly as entered. The MCP then. generates 
approcriate responses which are sent to. the terminat via the 
Network Controller. Security restrictions have imposed certain 
constraints on MCP commands from reacte termirais. Also» certain 
commands» such as those which alter systew oftions» purges» or 
clear system peripherals» have teer disaltlcwed for a remote 
terminal. The following List represents the MCP command subset 
permitted from User System terminals and the User ooT. . 


The fcllowing Command Subset is tistec in the order as described 
in tke 81800/81700 Systeas Systes Software Operational Guide 
Cassociated dccumentation).-. Any ccamand listed below which is 
suffixed with "US" requires the ccamand to be entered with a 
valid "usercode*/"password™ combiraticne 


Library Maintenance Instructions 


e« CH Change CUS) 
- AD Add CUS) 

« LO Load CUS) 

- OU Cuamp CUS) 

e UN Unload CUS) 
« RE kemove (CUS) 


Program Control Instructions 


» CQ Compite CUS) 
« DY COynamic 

EX Execute CUS) 
Modify Header CUS) 
MO Modify CUS) 
Co Compile. Cus) 


eo 6 & @ 
= 
xz 


Programs Control Instruction Attributes 


- AF After 

- AN After.-Number 

- CA Conditional 

- CG Charge Ccertain restrictions apply) 
- ODS Oynamic.eSpaces 

» FI Fite 

« FR Freeze 

e HO Hold 

- IN Interp interpreter 
- IT Intrinsic-eNase 

- ID Intrinsic.Cirectory 
- ME Memory 
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- OV Override 

« PR Priority . 

« SC Schedule-Pricrity 
- SW Switch 


- TH Then . 
« UC Unconditional 
- UF Unfreeze 

- UV Unoverride 


6 
< 
a 


Virtual.Disk 


System Control Instructions 


- AX Response to ACCEPT 

- BF Display BACKUP files CUS) 

- CP Compute: 

« CU Core usage 

- OF ODate cf file CUS) 

- DM Dusp memory and cortirue 

- DP Dump memory and discortinue 
- DS Discontinue prograr 

- FN Display internal file rae 
«FR Final reet of unlabeled tape file 
« FS Force froe schedule 

- GO Resume stopped progras 

e HS Hold in waiting schedule 

- HW Hold ir waiting schedule until job EOJ 
- MR Close output file witht purge 
- MX Display VIX 

- OF Optional file resrfonse 

- OK Continue processing | 

- QL Display peripheral status 

- POD Display directory 

- PM Print memory duap 

e PR Change priority 

- OK Continue processing 


System Control Instructions Ccontinued) 


- PS Prod schedule 

- QF Query file CUS) 

- QP Query prograa 

- RB Remove backup files (US) 


- RM Remove duplicate disk file 
- RS Remove jobs from schecule 
- SP Change schedule pricrity 

- ST Suspend processing 

- SW Set switch 

- TD Time ard date 

- Ti Time interrogation 

-« TS Test switches 

« UL Assign unlabeled file 


e 
xc 
o 


Disptay MCP date 
» WM Display current MCP ard interpreter 


f= 3 


BURROUGHS CORPCRATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP 81800/81700 SYCOM 
SANTA BARBARA PLANT . Pe Se 2219 0458 CA) 


- WS Display schedule 
WT Pisptlay MCP time 
WY Program status interrcgstion 


Job Spawning Control Attributes 


- QU Queue command 
- US Usercode command 
- Z2Q Zp cueue command 


MIX related MCP commards may refer crly to joks initiated by the 
same remote terminal where the initial command was inpute. Alt 
MCP ccmmands wust be entered in UPPER CASE. 
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APPENDIX G: PARAMETERS FILE ATTRIBUTES 
The PARAMETERS file is a disk files data types with one physicat - 


record of 180 characters. This paraseters record is formatted as 
Shown belowe © 


RECORE FORMAT 


Length Default 
Field Cin bits) Value Description 
Versian oe 8 - ee" Current verston of file. 
Fitler- 7 9%. 8 Reserved for identifier. 
CURRENTeDATE - 720 fun date as "dd aw yye? Co: 
: bytes). 
STATICN.ID | «136 ons System identifiers 17 bytes. 
MAXeBLFFERSIZE 24 © 1950 File Trarsfer buffer size. 
MAXe MESSAGES rr) re | NOL: dteuersize? 
-TIMECUTSINTERVAL 24 0 # value for message display: 
Pn. ts : intervals. : 
DEBUGGING ee a "9s LEBUG on/off switch. Default 
: ef "0" irhibits debugging. 
DISK.» TRACING tr  ° 4 Controts disk tracings O=no 
: : : aes l=yese 
NOFS te | ieee Ma 0 hhen “set*» this parameter 
. = inhibits File Separators. 
NOFTP.P ; ok. i 0 When “set"s this parameter 
cs permits File Transfers to 
cccurs else they are denied. — 
QUE.P 1) | 0 when “set"» this parameter 


permits "prograam Coe eure 
comaunications. 
cccurs else they are denied. 
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Length Default 
Cin bits) Value Cescription 
WAIT.WP 1 0 Tc shutdown or not shutdown 


when receiving a “disconnect 
message” from another SYCOUM. 
0 = shutdowns 1 = idlee . 


Filler | 2 00 Reserved for future use. 
Default N input 8 
buffers 
TRACE .R-B 16 4 Disk traces records per blk. 
Default A output 8 
buffers 
TRACE .BeA 16 10 Disk trace» blocks per are3. 
Default Pseudosignal @ | to PSEUDOSignal character 
character . 
TRACE AREAS e 10 Disk traces nuaber of areas. 
Fitter 8 . 00 Feserved for future use 
GROUPSIZE 24 9 Size of groups within a faaily 
cf the transfers 
TERMINALS RFE 24 000 Remote File Number for the 
file TERMINALSs 3 bytes. 
SYCO* prog name 240 SYCOM*"s names 30 bytes. 
SYCOM job number 32 SYCOM*'S “job #"3 4 bytes. 
Filler — 256 Reserved for identifier. 
COMPILE-DATE . 72 ed Compile date as “dd amm yy"™> 
(9 bytes). 
Fidler 256 = * - Reserved for identifier. 
COMPILE.~TIME 80 = .8 Compile time as “hhsamssset" 
(10 bytes). 
Filler 68 Reserved for future uSe@ececee 
Lccal Retease I/D 72 Release version identifier 


of the tocat SYCOM program. 


Remote Release I/C 72 Release version identifier 


ow wert 


cf tne reacte SYCO* program. 


Filler oe 16 Available. 


H-1 
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APPENDIX Ht SUMMARY OF FILES 


File  Records/ 
Number Internal Name External Name Device Block 
0 DEBUG” <sycom>/DEBUG ier. dat 
1 BISK_TRACE §  <sycom>/TRACE disk 132/4 
2 FILE_NAMES | FILE_NAMES disk | 72/1 
3 FILENAME_Q = FILENAMES - ~~ queue 18071 
4 IN | IN & - disk/tape *180/1«— 
5 IN_ OUT | <sycoe>/Ih_ OUT PBD 132/1 
6 IN_¢ | <sycom>/INa queue 2000/1 
7 Link LINK # remote 2000/1 
_ LIAK_Q <sycom>/LINK.»Q queue 2000/1 
9 LIST — Ssycom>/LIST.TRACE printer 132/1 
10 NEWPARAMS  €sycow>/NEWPARAMS card/disk 80/1 
11. OLCTRACE <sycom>/CLDIRACE disk | 1327/4 
12 out OUT ** ; disk/tape *180/1* 
13 puta —— ésycom>/OLTa queue 2cocsl 
14 PARAMETERS <sycom>/PARAMETERS disk 18071 
i5 PUT_QFILE <sycom>/PLTsQUEUE disk 358/1 
16 RJE_ <sycom>/RJE 0 queue 455/1 
17 RJECARCS | RJE/CARDS # card sos 
18 RJEPRINT RJE/PRINT | printer + 132/1 
19 RJEPUNCH RJE/PUNCH punch + 80/1 
20 STATISTICS <sycom>/STATISTICS disk ~ 180/1 
21 TERMINALS TERMINALS | remote 2000/1 
SS > 35°95 552-2 25-5 S552 535552 > S532 355555555525 55S 555-255 ==—=4+ 


* - These files are changed to the actual device type» 
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record size» and file nage specified in the file 
transfer command. 
+ 6° Backup al lowed: 
# - Or user specified name. 
~ °* Use input blocking. 


* Note: Printer or printer backup cisk file. ; 
*«* Note: The actual file name as srecified ir the COPY command. 
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APPENDIX I: SAMPLE APPLICATION PROGRAMS 


This program was designed basically te test “prograa-to-prograar" 
communication functions of SYCOM. What this sasple application 
proaréem provides is the mechanics cf what is recessary for this 
comsunication process. The user car expand upon this sample to 
create a program with the desired capabilities as required. The 


program is written in UPL which is available for this purpose. 


The orly data communication type functions required for this type 
of apclicetion program is to “read™ irput messages from a Remote 
File and “write” repiy messages into the same Remote File. This 
message interfacing architecture has keen established for this 
purpose and must tes therefores adherec to at atl times. 


PROGCRAM@*tomPROCGCRAM CUser System) 


-COMPILE USER/STEST UPL LI, 


&R DETAIL 
& SIZE 
& PASS_END 


FILE RFUSER CDEVICE = REMOTE» NLMBER_OF_STATIONS = 1; 
REMOTE_KEYs» RECORDS = 80/1» BUFFERS = 


DEFINE CH AS #CKARACTERGs 
DECLARE TEXT Ch (C8&0)> 
REPLY CH C€8&C)> 
DECLARE 1 RMT_KEY CH C10). 
. 2 RMT_RSN CH € 3)» 
2 RMT_LENGTH CH € 4)» 
2 FVT_TYPE CH € 3)»e 
1 REAC_KEY CH (10)> 
2 FEAD_RSN CH € 3)» 
2 FEAD_LENGTH CH € 4)» 
2 READ_TYPE CH € 3)3 
RPY_RSN 2= "OO01%S Z First station in “family”. 
RMT_LENGTH := "0080"; % Starcard messace lengthe 
RMT_TYPE s= "OQ00"5 %& MCS tyce code. 


OPEN RFUSEF INPUT» 


OUTPUTs 


[=z 
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Oc TEST_LOOP FOREVER; 


ACCEPT TEXT? 


Qutputs messages 
directty to the 
Network Controller 
for delivery to the 
other system. 


WRITE RFUSER CRMT_KEY) CTEXT)> 


NNN NR 


READ FUSER CREAD_KEY] CREPLY)% % Obtains input directly 
. 2 for the Network 
Z% Controller. 
ON EOF STOP? % In case of "9C" 
DISPLAY REPLYS | 


EAC TEST_LOCPS 


secteen-- shalaiaataiaaetedatatatatatane 1 aaa ere esecececnne wr eeecee-- 


PROCRAM=to-PRCGRAM CServer Systea) 


COMPILE SERVER/TEST UPL ~LI> 


& DETAIL 
& SIZE | 
& PASS_END 
FILE RFSERVER (DEVICE = REMOTE» NUMBER_OF_STATIONS = to. 
REMOTE_KEY» RECORDS = 80/1> BUFFERS = 2)3 
DEFINE CH AS SCHARACTERGS 
DECLARE TEXT CH C80)» 
1 RMT_KEY CH C10)> 
2 RMT_RSN CH C 3)» 
2 RMT_LENGTH CH C 4)» 
2 RMT_TYPE CH C 3)» 
1 READ_KEY CH C10)» 
2 READ_RSN CH ( 3)> 
2 REAO_LENGTH CK C 4)» 
2 READ_TYPE CH  3)3 
RMT_RSN 


2= "001"5 Z First station in “family” 
RMT_LENGTH 2= "0080"-  %Z% Standard message length 
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RMI_TYPE == "000"F = 2% MCS tyfe code | 


OPEN RFSERVER INPUTs QUTPUT> 


NG TEST_LOCP FOREVER; 
REAC RFSERVER (CREAD_LKEY] CTEXT)> % Input from User aP 
ON EOF STOPs, Z In case of "QC"... 
WRITE RFSERVER (CRMT_KEY] CTEXT)s %Z Output te User AP 
ENC TEST_LCCPs 
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